Docs

Sözlükler

Son güncelleme: 2026-10-022 dk okuma

İlan yanıtlarında kategori ve özellik alanları kod olarak gelir (örneğin type: "Residential", condition: "Cosmetic renovation", utilitySystem: ["gas", "water"]). Bu uç nokta, kodları desteklenen 10 dilden herhangi birinde okunabilir etiketlere çevirir. Ücretsizdir ve her anahtara açıktır.

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

Tek bir dil için etiketler

GET /dictionaries?lang=tr
Authorization: Bearer gsk_live_...

O dil için { code: label } biçiminde düzleştirilmiş tüm sözlükleri döndürür:

{
  "version": "sha256-...",
  "lang": "tr",
  "dictionaries": {
    "propertyType": { "Residential": "Konut", "Commercial": "Ticari", ... },
    "condition": { ... },
    "utilitySystem": { ... },
    ...
  },
  "requestId": "req_..."
}

Desteklenen lang değerleri: en, ru, uk, de, es, az, ar, fr, zh, tr. Diğerleri 400. Bir kodun istenen dilde etiketi yoksa İngilizcesi döndürülür.

Varyantlar

  • Tüm diller bir arada: lang parametresini çıkarın. Her kod bir labels nesnesiyle gelir: { "value": "Residential", "labels": { "en": "Residential", "uk": "Житлова", ... } }.
  • Tek bir sözlük: name ekleyin, örneğin GET /dictionaries?name=propertyType&lang=tr. Bilinmeyen ad 404.

Mevcut sözlükler

propertyType, residentialType, commercialType, industrialType, condition, utilitySystem, amenities, onsiteAmenities, apartType, apartmentType, status, objectType.

Yanıtın bir version değeri vardır ve bir gün boyunca önbelleğe alınır: bir kez indirip yeniden kullanın. Zamanla yeni kodlar eklenebilir; önbelleğe aldığınız kopyada bir kod yoksa hata vermek yerine ham kodu gösterin.

Bu makale yardımcı oldu mu?