Docs

Справочники

Последнее обновление: 2026-10-022 мин чтения

В ответах объектов поля категорий и атрибутов возвращаются как коды (например, type: "Residential", condition: "Cosmetic renovation", utilitySystem: ["gas", "water"]). Этот эндпоинт превращает коды в человеческие названия на любом из 10 поддерживаемых языков. Запрос бесплатный и доступен любому ключу.

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

Названия для одного языка

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

Возвращает все справочники, свернутые в { code: label } для этого языка:

{
  "version": "sha256-...",
  "lang": "ru",
  "dictionaries": {
    "propertyType": { "Residential": "Жилая", "Commercial": "Коммерческая", ... },
    "condition": { ... },
    "utilitySystem": { ... },
    ...
  },
  "requestId": "req_..."
}

Поддерживаемые lang: en, ru, uk, de, es, az, ar, fr, zh, tr. Другое значение - 400. Если для кода нет подписи на нужном языке, возвращается английская.

Варианты

  • Все языки сразу - не передавайте 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, и он кэшируется на сутки - запросите один раз и переиспользуйте. Коды могут добавляться со временем, поэтому при отсутствии кода в вашей кэш-копии используйте сам код как запасной вариант, а не падайте с ошибкой.

Эта статья была полезной?