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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

الإدارة

تدوير سر توقيع Webhook

POST/organization/webhooks/{webhook_id}/rotate-secret

يصدر سر توقيع جديدًا يظهر مرة واحدة في الاستجابة. طوال overlap_seconds (الافتراضي 86400، حتى 7 أيام؛ 0 بلا تداخل) يحمل كل تسليم توقيعًا للسر الجديد والسابق معًا، فيمكن للمستقبِل التحقق بأيٍّ منهما أثناء التداخل. يجب على المستقبِل قبول الترويسة إذا طابق أي إدخال v1: إدخال السر الجديد يأتي أولًا، فالمحلل الذي يقرأ آخر v1 فقط يحصل على توقيع السر السابق حتى ينتهي التداخل. بعد تسرّب استخدم 0. التدوير مجددًا أثناء التداخل يُسقط السر الأقدم.

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

المعاملات

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

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

جسم الطلب

الاسمالوصف
overlap_secondsالنوع: integer

المدة التي يواصل فيها السر السابق التوقيع. الافتراضي 86400.

الاستجابة

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

الاسمالوصف
idمطلوبالنوع: string
secretمطلوبالنوع: string

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

previous_secret_expires_atمطلوبالنوع: string (date-time) | null

وقت توقف السر القديم عن التوقيع؛ null إن توقف فعلًا.

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

cURL
curl -X POST "https://api.kite.sa/v1/organization/webhooks/webhook_id/rotate-secret" \  -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.rotateSecret("webhook_id", {});
Python (kite-sa)
import osfrom kite_sa import Kitekite = Kite(api_key=os.environ["KITE_ADMIN_KEY"])result = kite.organization.webhooks.rotate_secret("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}/update
  • إعادة تفعيل نقطة WebhookPOST /organization/webhooks/{webhook_id}/enable
  • حذف نقطة 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