عرض استيعاب المشروع شهرًا بشهر
GET/projects/{id}/absorption
مدى سرعة خروج الوحدات المعروضة في المشروع، لكل شهر تقويمي: الوحدات المعروضة في بداية الشهر ونهايته، والوحدات الخارجة، والوحدات العائدة والمطروحة، ومعدل الاستيعاب (الوحدات الخارجة ÷ وحدات البداية)، وأشهر المخزون المتبقية بهذه الوتيرة. لكل شهر reliability وflags التي تفسّرها؛ وللمشروع history_days وreliability عامة.
هذا ليس سجل مبيعات. عدد الوحدات «المتاحة» في بوابة عقارية أو موقع مطوّر هو ما عرضته الصفحة في ذلك اليوم. تُعدّ الوحدة خارجة حين يتوقف المصدر عن عرضها، ويبدو ذلك من الخارج واحدًا سواء بيعت أو حُجزت أو أُجّرت أو سحبها المطوّر من الصفحة؛ والحجوزات قد تُلغى، والمطوّرون يحجبون وحدات. اقرأ الأرقام على أنها سرعة تقلّص العرض المعلن، وارجع إلى الصفقات المسجلة حين تحتاج المبيعات الفعلية.
أي المشاريع. لا يمكن القياس إلا من مصادر تنشر عددًا للمخزون: جداول وحدات بحالة لكل وحدة (أساس مكين ورسن؛ basis unit_status)، أو عدد متاح معلن (Mada؛ reported_available)، أو عدد الوحدات المدرجة في صفحة المشروع (وصلت وCompoundIn؛ listed_units). عدد الوحدات في بقية المصادر هو حجم المشروع ولا يتحرك مع البيع، فمعظم المشاريع قيمة reliability فيها no_inventory_signal. لا يذكر أي مصدر الوحدات المتاحة بحسب نوع الوحدة، فلا تقسيم بحسب النوع؛ ويفصل listing_type البيع عن الإيجار حيث يفصلهما المصدر. تُقرأ نسخ المشروع الواحد من عدة مصادر مرة واحدة، من المصدر ذي الأساس الأفضل. بدأت اللقطات في 2026-09-26.
ما يُستبعد. تُستبعد من units_gone الحركة التي ليست من السوق، وتُسمّى في flags لكل شهر: قراءتان تفصل بينهما أكثر من 8 أيام (gap)، واختفاء المخزون كله دفعة واحدة دون تعليمه مباعًا أو محجوزًا (withdrawal)، ويوم تغيّر فيه 40% أو أكثر من مشاريع مصدر واحد (source_change)، وفي جداول الوحدات، الوحدات التي تخرج من الجدول دون تعليمها مباعة أو محجوزة (units_removed). خروج المشروع من النشاط أو إسقاط المصدر له ينهي سلسلته، ولا يُقرأ أبدًا على أنه نفاد. تُذكر الوحدات التي تظهر بوصفها units_released (مرحلة جديدة) أو units_re_added، ولا تُطرح أبدًا من الوحدات الخارجة.
تعيد 404 للمشاريع غير النشطة وللنسخ المدمجة في مشروع آخر؛ ويعرض GET /projects/{id}/availability اللقطات اليومية الخام.
- المصادقة
- أرسل مفتاح بيانات (dk_live_… أو dk_test_…) بصيغة Bearer.
- النطاق
projects- التكلفة
- 10 وحدات لكل طلب
المعاملات
| الاسم | الوصف |
|---|---|
idمطلوبالنوع: integer · المسار | معرّف المشروع. |
listing_typeالنوع: string · الاستعلام | أي مخزون يُقرأ: وحدات البيع إحدى القيم: |
fromالنوع: string · الاستعلام | أول شهر ( |
toالنوع: string · الاستعلام | آخر شهر ( |
الاستجابة
الحقل data كائن بهذه الحقول.
| الاسم | الوصف |
|---|---|
project_idمطلوبالنوع: integer | |
listing_typeمطلوبالنوع: string | إحدى القيم: |
fromمطلوبالنوع: string | |
toمطلوبالنوع: string | |
basisمطلوبالنوع: string | null | ما يمثله عدد المخزون: |
basis_sourceمطلوبالنوع: string | null | المصدر الذي تُقرأ منه السلسلة. |
reliabilityمطلوبالنوع: string |
إحدى القيم: |
history_daysمطلوبالنوع: integer | الأيام من أول قراءة في السلسلة إلى آخرها. |
first_observedمطلوبالنوع: string | null | |
last_observedمطلوبالنوع: string | null | |
readingsمطلوبالنوع: integer | الأيام التي فيها قراءة للمخزون. |
latest_availableمطلوبالنوع: integer | null | الوحدات المعروضة عند آخر قراءة. |
usable_monthsمطلوبالنوع: integer | |
units_gone_per_monthمطلوبالنوع: number | null | الوتيرة في آخر ثلاثة أشهر صالحة (أو أقل)، بالوحدات في الشهر. |
months_of_stockمطلوبالنوع: number | null |
|
monthsمطلوبالنوع: object[] |
نقاط نهاية ذات صلة
- البحث في المشاريع العقارية
GET /projects - جلب مشروع عقاري
GET /projects/{id} - قائمة وحدات مشروع
GET /projects/{id}/units - توافر وحدات المشروع عبر الزمن
GET /projects/{id}/availability - البحث في وحدات المشاريع
GET /project-units - قائمة المطورين
GET /developers - استيعاب المشاريع بحسب المنطقة أو المطوّر أو النوع
GET /market/absorption