В ответах объектов поля категорий и атрибутов возвращаются как коды (например, type: "Residential", condition: "Cosmetic renovation", utilitySystem: ["gas", "water"]). Этот эндпоинт превращает коды в человекочитаемые названия на любой из 8 поддерживаемых локалей.
Базовый URL: https://developers.grem.capital/api/v1.
Названия для одной локали
GET /dictionaries?lang=ru
Authorization: Bearer gsk_live_...
Возвращает все словари, свёрнутые в { code: label } для этой локали:
{
"version": "2026-07-24",
"lang": "ru",
"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", "ru": "Жилая", ... } }. - Один словарь — добавьте
name, напримерGET /dictionaries?name=propertyType&lang=ru. Неизвестное имя —404.
Доступные словари
propertyType, residentialType, commercialType, industrialType, condition, utilitySystem, amenities, onsiteAmenities, apartType, apartmentType, status, objectType.
В ответе есть version, и он кэшируется на сутки — запросите один раз и переиспользуйте. Коды могут добавляться со временем, поэтому при отсутствии кода в вашей кэш-копии используйте сам код как запасной вариант, а не падайте с ошибкой.