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

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

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

الإعلانات

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

بيانات السوق

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

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

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

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

الإعلانات

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

بيانات السوق

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

الإدارة

إنشاء مفتاح بيانات

POST/organization/keys

ينشئ مفتاح dk_live_…. يظهر السر مرة في الاستجابة؛ احفظه الآن. يُحسب ضمن حد المفاتيح النشطة لخطتك.

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

المعاملات

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

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

جسم الطلب

الاسمالنوعالوصف
nameمطلوبstring
project_idstring

الافتراضي مشروعك الأول.

scopesstring[]

قيّد المفتاح بهذه الواجهات؛ احذفه لكل واجهات خطتك.

Kite API

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

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

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

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

التحليلات

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

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

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

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

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

التصدير

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

الإدارة

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

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

expires_atstring (date-time)

الاستجابة

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

الاسمالنوعالوصف
idمطلوبstring
nameمطلوبstring
keyمطلوبstring

السر، يُعرض مرة واحدة.

hintمطلوبstring

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

curl
curl -X POST "https://api.kite.sa/v1/organization/keys" \
  -H "Authorization: Bearer $KITE_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string"}'
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.keys.create({ name: "string" });
Python (kite-sa)
import os
from kite_sa import Kite

kite = Kite(api_key=os.environ["KITE_ADMIN_KEY"])
result = kite.organization.keys.create(name="string")

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

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

  • جلب مؤسستك GET /organization
  • قائمة مفاتيح البيانات GET /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 POST /organization/webhooks
  • قائمة نقاط 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
  • الحدود والحصص
  • الأخطاء