Услуги (Amenities)#

Получение справочника дополнительных услуг отеля и номера.

Описание#

Эндпоинт: GET /api/dictionary/hotels/amenities

Возвращает справочник дополнительных услуг отеля и номера (Amenities — единое наименование услуг во всём API), используемый для расшифровки услуг в карточке отеля и в предложениях размещения. Справочник глобальный — результат не зависит от клиента, языка запроса или иного контекста.

Каждая услуга может быть сгруппирована по категории (group) и иметь уровень предоставления (level): Hotel, Room или Apartment. Если у услуги нет категории — оба поля отсутствуют одновременно.

Источник данных этого справочника не поддерживает фильтрацию удалённых записей — исключаются ли удалённые услуги по умолчанию, не подтверждено.

Использование#

Используйте этот запрос для расшифровки идентификаторов услуг, встречающихся в карточке отеля и предложениях размещения.

Основной сценарий#

  1. Отправьте запрос GET /api/dictionary/hotels/amenities
  2. Получите полный список услуг с группами и уровнем предоставления, отсортированный по id

Базовый пример#

1GET /api/dictionary/hotels/amenities

Ответ содержит:

 1[
 2  {
 3    "id": 610,
 4    "nameRu": "Халат в отдельных номерах",
 5    "nameEn": "Bathrobe in some rooms",
 6    "group": { "id": 2, "nameRu": "В номерах", "nameEn": "In-room" },
 7    "level": "Hotel"
 8  },
 9  {
10    "id": 613,
11    "nameRu": "Церковь",
12    "nameEn": "Church",
13    "group": { "id": 1, "nameRu": "Общее", "nameEn": "General" },
14    "level": "Hotel"
15  }
16]

Детальная документация#

Типичные ошибки#

Код ошибкиПричинаРешение
401Отсутствует / невалиден JWTПроверьте Authorization header
500Внутренняя ошибка сервисаПовторите запрос позже