توافر وحدات المشروع عبر الزمن
GET/projects/{id}/availability
لقطات يومية لعدد وحدات المشروع والتوافر الذي يعلنه مصدره، بنقاط يومية أو أسبوعية أو شهرية، ومع كل نقطة عدد الوحدات التي خرجت من السوق منذ النقطة السابقة.
هذا توافر معروض وليس عقودًا: يأتي مما أظهرته صفحة مصدر المشروع في ذلك اليوم، فتُحتسب الوحدة مستوعَبة حين يتوقف المصدر عن عرضها، لا حين تُباع أو تُؤجَّر. بدأت كايت حفظ اللقطات في 2026-09-26 (ولا لقطات قبل ذلك)؛ ويبيّن coverage النطاق المحفوظ لهذا المشروع. بعض المصادر فقط تُعلن الوحدات المتاحة؛ وحيث لا تفعل تكون available_units وabsorbed_since_previous فارغتين (null) وتكون total_units عدد وحدات المشروع. يحصر unit_type كلًا من total_units وunit_types في نوع واحد للمصادر التي ترسل أعدادًا حسب النوع. الافتراضي آخر 90 يومًا، وبحد أقصى 366. يعيد 404 للمشاريع غير النشطة.
- المصادقة
- أرسل مفتاح بيانات (dk_live_… أو dk_test_…) بصيغة Bearer.
- النطاق
projects- التكلفة
- 10 وحدات لكل طلب
المعاملات
| الاسم | الوصف |
|---|---|
idمطلوبالنوع: integer · المسار | معرّف المشروع. |
intervalالنوع: string · الاستعلام | الفاصل بين النقاط؛ كل نقطة هي آخر لقطة في يومها أو أسبوعها أو شهرها. إحدى القيم: |
fromالنوع: string · الاستعلام | أول يوم ( |
toالنوع: string · الاستعلام | آخر يوم ( |
unit_typeالنوع: string · الاستعلام | نوع الوحدة كما يسميه المصدر (مثل |
الاستجابة
الحقل data كائن بهذه الحقول.
| الاسم | الوصف |
|---|---|
project_idمطلوبالنوع: integer | |
intervalمطلوبالنوع: string | إحدى القيم: |
fromمطلوبالنوع: string | أول يوم في النطاق بصيغة |
toمطلوبالنوع: string | آخر يوم في النطاق بصيغة |
unit_typeمطلوبالنوع: string | null | |
coverageمطلوبالنوع: object | |
pointsمطلوبالنوع: object[] |
نقاط نهاية ذات صلة
- البحث في المشاريع العقارية
GET /projects - جلب مشروع عقاري
GET /projects/{id} - قائمة وحدات مشروع
GET /projects/{id}/units - البحث في وحدات المشاريع
GET /project-units - قائمة المطورين
GET /developers - عرض استيعاب المشروع شهرًا بشهر
GET /projects/{id}/absorption - استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع
GET /market/absorption