Услуги (Amenities)#
Получение справочника дополнительных услуг отеля и номера.
Описание#
Эндпоинт: GET /api/dictionary/hotels/amenities
Возвращает справочник дополнительных услуг отеля и номера (Amenities — единое наименование услуг во всём API), используемый для расшифровки услуг в карточке отеля и в предложениях размещения. Справочник глобальный — результат не зависит от клиента, языка запроса или иного контекста.
Каждая услуга может быть сгруппирована по категории (group) и иметь уровень предоставления (level): Hotel, Room или Apartment. Если у услуги нет категории — оба поля отсутствуют одновременно.
Источник данных этого справочника не поддерживает фильтрацию удалённых записей — исключаются ли удалённые услуги по умолчанию, не подтверждено.
Использование#
Используйте этот запрос для расшифровки идентификаторов услуг, встречающихся в карточке отеля и предложениях размещения.
Основной сценарий#
- Отправьте запрос GET /api/dictionary/hotels/amenities
- Получите полный список услуг с группами и уровнем предоставления, отсортированный по 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 | Внутренняя ошибка сервиса | Повторите запрос позже |