У відповідях обʼєктів поля категорій та атрибутів повертаються як коди (наприклад, 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, і вона кешується на добу — запитайте один раз і перевикористовуйте. Коди можуть додаватися з часом, тому за відсутності коду у вашій кеш-копії використовуйте сам код як запасний варіант, а не падайте з помилкою.