DocsAllemagneAfficher la version internationale de la base de connaissances

Dictionnaires

Dernière mise à jour: 2026-10-022 min de lecture

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 objet labels : { "value": "Residential", "labels": { "en": "Residential", "uk": "Житлова", ... } }.
  • Un seul dictionnaire - ajoutez name, par exemple GET /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.

Cet article vous a-t-il aidé ?