تحديث نقطة Webhook (POST /organization/webhooks/{webhook_id}/update) — Kite API
تخطَّ إلى المحتوى
Kiteالمنصة
الباقات
تصفح نقاط النهاية
كل نقاط النهاية

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

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

الإعلانات

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

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي
  • القطع المعروضة للبيع مقارنة بآخر صفقة مسجلة عليها
  • سعر البيع المسجل مقابل السعر المطلوب
  • الأماكن والسكان والمعالم حول نقطة أو في حي

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

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

التحليلات

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

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

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

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

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • توافر وحدات المشروع عبر الزمن
  • البحث في وحدات المشاريع
  • قائمة المطورين
  • عرض استيعاب المشروع شهرًا بشهر
  • استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

  • ملخص السوق
  • توزيع الأسعار
  • توزيع المساحات
  • المعروض الجديد
  • مؤشر الشغور
  • الأسعار بحسب الحي
  • الإيجار التجاري للمتر المربع بحسب الحي
  • القطع المعروضة للبيع مقارنة بآخر صفقة مسجلة عليها
  • سعر البيع المسجل مقابل السعر المطلوب
  • الأماكن والسكان والمعالم حول نقطة أو في حي

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

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

التحليلات

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

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

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

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

  • البحث في المشاريع العقارية
  • جلب مشروع عقاري
  • قائمة وحدات مشروع
  • توافر وحدات المشروع عبر الزمن
  • البحث في وحدات المشاريع
  • قائمة المطورين
  • عرض استيعاب المشروع شهرًا بشهر
  • استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع

التصدير

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

الإدارة

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

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

الإدارة

تحديث نقطة Webhook

POST/organization/webhooks/{webhook_id}/update

يغيّر رابط نقطة النهاية وأنواع أحداثها ومرشّحاتها ووصفها؛ أرسل ما يتغير فقط. يبقى السجل وسر التوقيع، ويبقى موضع كل نوع حدث يظل مشتركًا كما هو. نوع الحدث الذي تضيفه يبدأ من الآن ولا يعيد تشغيل القوائم السابقة للتغيير. إزالة نوع تُسقط موضعه، فإعادة إضافته تبدأ من الآن أيضًا. تنطبق المرشّحات الجديدة على الأحداث التي لم توضع بعد في الطابور. لا يعيد تفعيل نقطة معطّلة: استخدم نداء التفعيل.

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

المعاملات

الاسمالوصف
webhook_idمطلوبالنوع: string · المسار
Idempotency-Keyالنوع: string · الترويسة

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

جسم الطلب

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

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

filtersالنوع: object

الإعلانات المطلوبة لنقطة النهاية بمفردات GET /listings. تطابق فلاتر القطعة (zoning وcorner وstreet_width_min وwhite_land_fee وlast_sale_within_months وask_to_last_sale_max) حقل plot في الإعلان؛ ومع listing.delisted لا تطابق إلا ما دامت بيانات قطعة الإعلان المحذوف محفوظة، أي حتى عملية الجمع التالية. وتطابق plot_sold الصفقة نفسها (راجع plot.registered_sale_while_listed)، وتبقى محفوظة بعد حذف الإعلان.

descriptionالنوع: string | null

تؤدي القيمة null إلى المسح.

الاستجابة

الحقل 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

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

cURL
curl -X POST "https://api.kite.sa/v1/organization/webhooks/webhook_id/update" \  -H "Authorization: Bearer $KITE_ADMIN_KEY" \  -H "Content-Type: application/json" \  -d '{}'
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.update("webhook_id", {});
Python (kite-sa)
import osfrom kite_sa import Kitekite = Kite(api_key=os.environ["KITE_ADMIN_KEY"])result = kite.organization.webhooks.update("webhook_id")

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

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

  • جلب مؤسستك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
  • إنشاء نقطة WebhookPOST /organization/webhooks
  • قائمة نقاط WebhookGET /organization/webhooks
  • إعادة تفعيل نقطة WebhookPOST /organization/webhooks/{webhook_id}/enable
  • تدوير سر توقيع WebhookPOST /organization/webhooks/{webhook_id}/rotate-secret
  • حذف نقطة WebhookPOST /organization/webhooks/{webhook_id}/delete
  • قائمة عمليات التسليمGET /organization/webhooks/{webhook_id}/deliveries
  • إعادة تشغيل تسليمPOST /organization/webhooks/{webhook_id}/deliveries/{delivery_id}/replay

الأدلة

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

جاهز لإرسال أول طلب؟ خطة Sandbox مجانية. للأحجام الكبيرة أو الترخيص، تواصل معنا.

احصل على مفتاح APIتواصل معنا
Kite API

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

المنتج
  • تغطية البيانات
  • الباقات
  • المستثمرون والمطورون
  • فحوصات التقييم
  • التقنية العقارية والتطبيقات
المطورون
  • البدء السريع
  • الأدلة
  • مرجع API
  • خادم MCP
  • مكتبة JavaScript (npm)
  • مكتبة Python (PyPI)
  • سجل التحديثات
  • حالة الخدمة
الشركة
  • kite.sa
  • المدونة
  • تواصل معنا
  • الأمان
الشؤون القانونية
  • الشروط
  • المصادر وحقوق البيانات
  • الخصوصية
  • ملحق معالجة البيانات
  • جهات المعالجة الفرعية
© Kite