Справочники#

Методы Dictionary API для получения статической и справочной информации: карточка отеля, страны, города, типы объектов размещения, услуги, типы кроватей, типы питания. Значения из этих методов расшифровывают поля в ответах поиска и бронирования отелей.

Отличия от операций авиа и отелей:

  • все методы работают по GET, параметры передаются в URL;
  • данные read-only: наполняются на стороне источника, через API не редактируются;
  • справочники не зависят от конкретного поиска или бронирования — их можно запросить заранее и закэшировать на стороне клиента, они меняются редко.

Доступные операции#

Статическая информация по отелю#

Эндпоинт: GET /api/dictionary/hotels/{hotelId}/static

Подробная карточка отеля по hotelId: название, адрес, город и страна, координаты, контакты, категория, описание, удобства, фотографии, данные реестрового сертификата.


Страны#

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

Список стран для расшифровки страны расположения отеля или города.


Города#

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

Список городов заданной страны (обязательный параметр countryId) для расшифровки города расположения отеля.


Типы объектов размещения#

Эндпоинт: GET /api/dictionary/hotels/accommodation-types

Список типов объектов размещения (отель, хостел, апартаменты и т.п.) для расшифровки типа объекта в карточке отеля.


Услуги (Amenities)#

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

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


Типы кроватей#

Эндпоинт: GET /api/dictionary/hotels/bed-types

Список типов кроватей для расшифровки конфигурации номера (bedVariants) в предложениях размещения.


Типы питания#

Эндпоинт: GET /api/dictionary/hotels/meal-types

Список типов питания для расшифровки типа питания в карточке отеля и предложениях размещения.