إنشاء نقطة Webhook (POST /organization/webhooks) — Kite API
Kiteالمنصة
الاستخداماتالتوثيقالأدلةالباقات
تصفح نقاط النهاية
كل نقاط النهاية

البيانات المرجعية

  • قائمة المدن
  • قائمة الأحياء
  • قائمة جهات المدينة
  • قائمة قيم التعداد
  • حدود هذا المفتاح
  • ما يغطيه API

الإعلانات

  • البحث عن الإعلانات
  • عدّ الإعلانات
  • جلب الإعلانات بالمعرّف
  • جلب إعلان
  • سجل سعر إعلان

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي

البيانات الرسمية

  • الإيجارات المسجلة لدى الهيئة العامة للعقار
  • مؤشر كايت العقاري

التحليلات

  • جلب الإعلانات المقارنة
  • موقع سعر الإعلان في السوق
  • نطاق أسعار العرض القريبة لإعلان
  • إعلانات أقل من أسعار السوق
  • إعلانات أقل من أسعار السوق (المسار القديم)
  • العائد الإيجاري الإجمالي
  • اتجاهات الأسعار
  • مقارنة الأحياء

الصفقات المسجلة

  • البحث في الصفقات المسجلة
  • إحصاءات الصفقات المسجلة
  • أسعار الأراضي لكل م²

المشاريع على الخارطة

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • البحث في وحدات المشاريع
  • قائمة المطورين

التصدير

  • إنشاء تصدير
  • قائمة الصادرات
  • جلب تصدير

الإدارة

  • جلب مؤسستك
  • قائمة مفاتيح البيانات
  • إنشاء مفتاح بيانات
  • إلغاء مفتاح
  • قائمة مشاريع المؤسسة
  • الاستخدام اليومي
  • قائمة الأعضاء والدعوات
  • قائمة أحداث التدقيق
  • قائمة سجلات الطلبات
  • إنشاء نقطة Webhook
  • قائمة نقاط Webhook
  • حذف نقطة Webhook
  • قائمة عمليات التسليم
  • إعادة تشغيل تسليم

المرجع التفاعلي

كل نقاط النهاية

البيانات المرجعية

  • قائمة المدن
  • قائمة الأحياء
  • قائمة جهات المدينة
  • قائمة قيم التعداد
  • حدود هذا المفتاح
  • ما يغطيه API

الإعلانات

  • البحث عن الإعلانات
  • عدّ الإعلانات
  • جلب الإعلانات بالمعرّف
  • جلب إعلان
  • سجل سعر إعلان

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي

الإدارة

إنشاء نقطة Webhook

POST/organization/webhooks

يشترك رابط HTTPS في أحداث الإعلانات. يظهر سر التوقيع مرة في الاستجابة؛ احفظه للتحقق من التسليم. يجب تضمين مدينة في المرشّحات.

المصادقة
أرسل مفتاح إدارة (dk_admin_…) بصيغة Bearer. مفاتيح البيانات مرفوضة هنا.
النطاق
organization
التكلفة
مجاني

المعاملات

الاسمالنوعالوصف
Idempotency-Keyالترويسةstring

سلسلة فريدة، ويفضل UUID، تجعل الطلب آمنًا عند التكرار. المفتاح والجسم نفسيهما يعيدان الاستجابة الأولى مع Idempotent-Replay: true؛ مع جسم مختلف يعيد 409 idempotency_key_reuse. تُحفظ 24 ساعة.

جسم الطلب

الاسمالنوعالوصف
urlمطلوبstring
event_typesمطلوبstring[]

راجع دليل Webhooks.

إحدى القيم: listing.created,

Kite API

بيانات العقارات السعودية للمطوّرين.

المنتج
  • مرجع API
  • تغطية البيانات
  • الباقات
  • فحوصات التقييم
  • سجل التحديثات
  • حالة الخدمة
الشركة
  • kite.sa
  • تواصل معنا
  • الأمان
الشؤون القانونية
  • الشروط
  • جهات المعالجة الفرعية
© Kite
الإيجار التجاري للمتر المربع بحسب الحي

البيانات الرسمية

  • الإيجارات المسجلة لدى الهيئة العامة للعقار
  • مؤشر كايت العقاري

التحليلات

  • جلب الإعلانات المقارنة
  • موقع سعر الإعلان في السوق
  • نطاق أسعار العرض القريبة لإعلان
  • إعلانات أقل من أسعار السوق
  • إعلانات أقل من أسعار السوق (المسار القديم)
  • العائد الإيجاري الإجمالي
  • اتجاهات الأسعار
  • مقارنة الأحياء

الصفقات المسجلة

  • البحث في الصفقات المسجلة
  • إحصاءات الصفقات المسجلة
  • أسعار الأراضي لكل م²

المشاريع على الخارطة

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • البحث في وحدات المشاريع
  • قائمة المطورين

التصدير

  • إنشاء تصدير
  • قائمة الصادرات
  • جلب تصدير

الإدارة

  • جلب مؤسستك
  • قائمة مفاتيح البيانات
  • إنشاء مفتاح بيانات
  • إلغاء مفتاح
  • قائمة مشاريع المؤسسة
  • الاستخدام اليومي
  • قائمة الأعضاء والدعوات
  • قائمة أحداث التدقيق
  • قائمة سجلات الطلبات
  • إنشاء نقطة Webhook
  • قائمة نقاط Webhook
  • حذف نقطة Webhook
  • قائمة عمليات التسليم
  • إعادة تشغيل تسليم

المرجع التفاعلي

listing.price_changed
, listing.delisted
filtersمطلوبobject

الإعلانات المطلوبة لنقطة النهاية بمفردات GET /listings.

descriptionstring

الاستجابة

الحقل data كائن بهذه الحقول.

الاسمالنوعالوصف
idمطلوبstring
urlمطلوبstring
event_typesمطلوبstring[]
filtersمطلوبobject
descriptionمطلوبstring | null
statusمطلوبstring

إحدى القيم: active, disabled

disabled_reasonمطلوبstring | null

too_many_failures عند الإيقاف بعد فشل متكرر.

consecutive_failuresمطلوبinteger
created_atمطلوبstring (date-time)

وقت بصيغة ISO 8601

secretمطلوبstring

سر التوقيع؛ يُعرض مرة واحدة.

مثال على الطلب

curl
curl -X POST "https://api.kite.sa/v1/organization/webhooks" \
  -H "Authorization: Bearer $KITE_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/kite-webhook","event_types":["listing.created"],"filters":{"city":"riyadh"}}'
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";

const kite = new Kite({ apiKey: process.env.KITE_ADMIN_KEY });
const result = await kite.organization.webhooks.create({ url: "https://example.com/kite-webhook", event_types: ["listing.created"], filters: { city: "riyadh" } });
Python (kite-sa)
import os
from kite_sa import Kite

kite = Kite(api_key=os.environ["KITE_ADMIN_KEY"])
result = kite.organization.webhooks.create(url="https://example.com/kite-webhook", event_types=["listing.created"], filters={"city": "riyadh"})

افتح في المرجع التفاعلي

نقاط نهاية ذات صلة

  • جلب مؤسستك GET /organization
  • قائمة مفاتيح البيانات GET /organization/keys
  • إنشاء مفتاح بيانات POST /organization/keys
  • إلغاء مفتاح POST /organization/keys/{key_id}/revoke
  • قائمة مشاريع المؤسسة GET /organization/projects
  • الاستخدام اليومي GET /organization/usage
  • قائمة الأعضاء والدعوات GET /organization/members
  • قائمة أحداث التدقيق GET /organization/audit-events
  • قائمة سجلات الطلبات GET /organization/request-logs
  • قائمة نقاط Webhook GET /organization/webhooks
  • حذف نقطة Webhook POST /organization/webhooks/{webhook_id}/delete
  • قائمة عمليات التسليم GET /organization/webhooks/{webhook_id}/deliveries
  • إعادة تشغيل تسليم POST /organization/webhooks/{webhook_id}/deliveries/{delivery_id}/replay

الأدلة

  • البدء السريع
  • المصادقة
  • الإشعارات عبر Webhooks
  • الحدود والحصص
  • الأخطاء