الكائنات (قراءة)

اقرأ الكتالوج العام للإعلانات - property وrental وcomplex (مشروع). وتتبع الردود عقد قراءة صريحا وثابتا (قائمة سماح)، فلا تتسرب الحقول الداخلية أبدا ولا تظهر حقول النموذج الجديدة على غفلة. والقراءات بطلبات GET وهي مجانية (لا تحتسب من حصة استدعاءات API لديك).

العنوان الأساسي: https://developers.grem.capital/api/v1.

القائمة

GET /objects?kind=property&city=Kyiv&page=1&limit=20&sort=newest
Authorization: Bearer gsk_live_...

معايير الطلب:

• kind (إلزامي) — property أو rental أو complex
• city وcountry (اختياريان) — مرشحا مطابقة تامة
• page (افتراضيا 1)، وlimit (افتراضيا 20، وأقصاه 50)
• sort — newest (افتراضي) أو oldest

الرد:

{
  "data": [ { "id": "...", "kind": "property", "name": "...", "price": 120000, "currency": "USD", ... } ],
  "paginate": { "currentPage": 1, "totalPages": 471, "totalCount": 9412 },
  "requestId": "req_..."
}

جلب عنصر واحد

GET /objects/{kind}/{id}
Authorization: Bearer gsk_live_...

القيمة {kind} هي property أو rental أو complex. ويعيد كائنا واحدا بالبنية نفسها مع requestId. أما المعرف غير المعروف فيعيد 404.

بنية الكائن

الحقول المشتركة (وتختلف المجموعة الدقيقة بحسب النوع):

• id وkind وname وslug وstatus (active أو sold) وcreatedAt
• price وcurrency (property/rental)؛ وprice: { from, to, currency } (complex)
• address — العنوان الكامل بما فيه street وإحداثيات location
• constructionYear — سنة من أربعة أرقام (null إن كانت مجهولة)
• المساحات كائنات: spaceAll: { "value": 50, "unit": "m2" }؛ وتلميح العرض هو nativeAreaUnit
• photos — [{ id, isMain, mimetype, variants, ready }]
• author — وكيل الإعلان أو وكالته (كتلة عامة منتقاة)
• ويضيف المجمع apartmentPlans[] (مخططات الوحدات) وprogress[] (سير البناء)

ماذا ترى

يتحدد الرد بحسب من تكون:

• أي كائن — البطاقة العامة للإعلان (ما يراه الزوار على grem.capital).
• إعلان بعمولة مفتوحة — بصفتك وسيطا مسجل الدخول ترى إضافة إلى ذلك المكافأة في عقد معتمد، فتقرر هل ترسل عميلا محتملا.
• كائناتك أنت — عرض المالك الكامل.

ولا يكشف لأحد أبدا: بيانات تواصل المالك الخاصة، وبيانات البائع المستوردة، وملاحظات المراجعة، وأصول الصور بلا علامة مائية، والمعرفات الداخلية.