قائمة وحدات مشروع

GET/projects/{id}/units

إعلانات كايت النشطة المرتبطة بمشروع: وحدات بيع بالسعر الإجمالي، وفي بعضها إيجارات سنوية. يُستبعد السعر المنخفض بشكل غير معقول للمدينة. يعيد 404 إذا لم يكن المشروع نشطًا.

المصادقة: أرسل مفتاح بيانات (dk_live_… أو dk_test_…) بصيغة Bearer.
النطاق: projects
التكلفة: ليس رقمًا وحدة لكل طلب

المعاملات

الاسم النوع الوصف

idمطلوبالمسار

integer

معرّف المشروع.

listing_typeالاستعلام

string

احذفه للنوعين. معظم وحدات المشاريع للبيع وبعضها للإيجار.

إحدى القيم: sale, rent

property_typeالاستعلام

string[]

قيمة أو أكثر، مفصولة بفواصل.

إحدى القيم: apartment, villa,

الاسم	النوع	الوصف
`id`مطلوب	`integer`	معرّف الإعلان؛ يعيد GET /listings/{id} الإعلان الكامل بنطاق `listings`.
`url`مطلوب	`string`	صفحة الإعلان في kite.sa.
`project`مطلوب	`object`
`link`مطلوب	`object`	طريقة ربط الإعلان بالمشروع: `source` إذا ذكره المصدر بثقة 1، أو `geo` داخل حدود المشروع أو بجوارها، أو `text` إذا ذُكر في النص. قد تُضاف أنواع جديدة.
`title`مطلوب	`string \| null`
`listing_type`مطلوب	`string`	إحدى القيم: `sale`, `rent`
`property_type`مطلوب	`string`
`sale_price_sar`مطلوب	`integer \| null`	سعر الشراء الإجمالي بالريال. null للإيجارات.
`yearly_rent_sar`مطلوب	`integer \| null`	الإيجار بالريال سنويًا بعد توحيد المنشور شهريًا أو يوميًا. null لوحدات البيع.
`bedrooms`مطلوب	`integer \| null`
`bathrooms`مطلوب	`integer \| null`
`area_sqm`مطلوب	`number \| null`
`floor`مطلوب	`string \| null`
`location`مطلوب	`object`
`images`مطلوب	`string[]`	حتى ثلاثة روابط صور في CDN كايت.
`source`مطلوب	`object`
`first_seen_at`مطلوب	`string (date-time) \| null`
`last_seen_at`مطلوب	`string (date-time) \| null`

قائمة وحدات مشروع

المعاملات

الاستجابة

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

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

الأدلة