İ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:
langparametresini çıkarın. Her kod birlabelsnesnesiyle gelir:{ "value": "Residential", "labels": { "en": "Residential", "uk": "Житлова", ... } }. - Tek bir sözlük:
nameekleyin, örneğinGET /dictionaries?name=propertyType&lang=tr. Bilinmeyen ad404.
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.