Nesneler (okuma)

İlanların herkese açık kataloğunu okuyun: property, rental ve complex (proje). Yanıtlar açık ve kararlı bir okuma sözleşmesine (izin listesine) uyar; böylece iç alanlar dışarı sızmaz ve modelin yeni alanları sürpriz biçimde belirmez. Okumalar GET'tir ve ücretsizdir (API çağrı kotanızdan düşmez).

Temel adres: https://developers.grem.capital/api/v1.

Liste

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

İstek parametreleri:

• kind (zorunlu) — property, rental ya da complex
• city, country (isteğe bağlı) — tam eşleşme süzgeçleri
• page (varsayılan 1), limit (varsayılan 20, en fazla 50)
• sort — newest (varsayılan) ya da oldest

Yanıt:

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

Tek kayıt alma

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

{kind} değeri property, rental ya da complex olur. Aynı yapıda tek bir nesne ve bir requestId döndürür. Bilinmeyen kimlik 404 döndürür.

Nesnenin yapısı

Ortak alanlar (tam küme türe göre değişir):

• id, kind, name, slug, status (active ya da sold), createdAt
• price, currency (property/rental); price: { from, to, currency } (complex)
• address — street ve location koordinatları dahil tam adres
• constructionYear — düz dört haneli yıl (bilinmiyorsa null)
• Alanlar nesnedir: spaceAll: { "value": 50, "unit": "m2" }; gösterim ipucu nativeAreaUnit
• photos — [{ id, isMain, mimetype, variants, ready }]
• author — ilanın danışmanı ya da ajansı (özenle seçilmiş herkese açık blok)
• Projede ayrıca apartmentPlans[] (ünite planları) ve progress[] (inşaat ilerlemesi) bulunur

Ne görürsünüz

Yanıt, kim olduğunuza göre kapsam kazanır:

• Herhangi bir nesne — ilanın herkese açık kartı (ziyaretçilerin grem.capital'da gördüğü).
• Açık komisyonlu bir ilan — kimliği doğrulanmış broker olarak, onaylanmış sözleşmedeki ödülü de görürsünüz; böylece lead gönderip göndermeyeceğinize karar verirsiniz.
• Kendi nesneleriniz — sahibin tam görünümü.

Kimseye açılmayanlar: mal sahibinin özel iletişim bilgileri, içe aktarılmış satıcı verileri, moderasyon notları, filigransız fotoğraf asılları ve iç kimlikler.