GREMDocs

Словники

Останнє оновлення: 2026-07-241 хв читання

У відповідях обʼєктів поля категорій та атрибутів повертаються як коди (наприклад, type: "Residential", condition: "Cosmetic renovation", utilitySystem: ["gas", "water"]). Цей ендпоінт перетворює коди на людські назви будь-якою з 8 підтримуваних локалей.

Базовий URL: https://developers.grem.capital/api/v1.

Назви для однієї локалі

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

Повертає всі словники, згорнуті в { code: label } для цієї локалі:

{
  "version": "2026-07-24",
  "lang": "uk",
  "dictionaries": {
    "propertyType": { "Residential": "Житлова", "Commercial": "Комерційна", ... },
    "condition": { "Cosmetic renovation": "Косметичний ремонт", ... },
    "utilitySystem": { ... },
    ...
  },
  "requestId": "req_..."
}

Підтримувані lang: en, ru, uk, de, es, az, ar, fr.

Варіанти

  • Усі локалі одразу — не передавайте lang. Кожен код повернеться з обʼєктом labels: { "value": "Residential", "labels": { "en": "Residential", "uk": "Житлова", ... } }.
  • Один словник — додайте name, наприклад GET /dictionaries?name=propertyType&lang=uk. Невідоме імʼя — 404.

Доступні словники

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

У відповіді є version, і вона кешується на добу — запитайте один раз і перевикористовуйте. Коди можуть додаватися з часом, тому за відсутності коду у вашій кеш-копії використовуйте сам код як запасний варіант, а не падайте з помилкою.

Ця стаття була корисною?