Dans les réponses concernant les annonces, les champs de catégorie et d'attribut arrivent sous forme de codes (par exemple type: "Residential", condition: "Cosmetic renovation", utilitySystem: ["gas", "water"]). Cet endpoint convertit les codes en libellés lisibles dans l'une des 10 langues prises en charge. Gratuit et accessible avec n'importe quelle clé.
URL de base : https://developers.grem.capital/api/v1.
Libellés pour une langue
GET /dictionaries?lang=en
Authorization: Bearer gsk_live_...
Renvoie tous les dictionnaires aplatis sous la forme { code: label } pour cette langue :
{
"version": "sha256-...",
"lang": "en",
"dictionaries": {
"propertyType": { "Residential": "Residential", "Commercial": "Commercial", ... },
"condition": { ... },
"utilitySystem": { ... },
...
},
"requestId": "req_..."
}
Valeurs de lang prises en charge : en, ru, uk, de, es, az, ar, fr, zh, tr. Toute autre valeur - 400. Lorsqu'un code n'a pas de libellé dans la langue demandée, le libellé anglais est renvoyé.
Variantes
- Toutes les langues à la fois - omettez
lang. Chaque code est accompagné d'un objetlabels:{ "value": "Residential", "labels": { "en": "Residential", "uk": "Житлова", ... } }. - Un seul dictionnaire - ajoutez
name, par exempleGET /dictionaries?name=propertyType&lang=en. Nom inconnu -404.
Dictionnaires disponibles
propertyType, residentialType, commercialType, industrialType, condition, utilitySystem, amenities, onsiteAmenities, apartType, apartmentType, status, objectType.
La réponse contient une version et est mise en cache pendant une journée - récupérez-la une fois et réutilisez-la. Des codes peuvent être ajoutés au fil du temps : lorsqu'un code est absent de votre copie en cache, affichez le code brut au lieu de générer une erreur.