Номерной фонд (json) — различия между версиями

Текущая версия на 12:09, 27 ноября 2024

Описание сервиса

Номерной фонд Слетать.ру даёт вам доступ к информации обо всех номерах, которые находятся в конкретных отелях, включая описание, фото номера и список удобств, присутствующих в нем.

Логика работы с сервисом

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

https://module.sletat.ru/Dictionaries.xml

Методы

В этом разделе описаны все методы поискового сервиса.

Информация о номерах

Метод возвращает информацию о всех номерах, которые есть в этом отеле.

Запрос:

https://api.sletat.ru/hotel-rooms-service/rooms/data/{hotelId}

Пример запроса:

https://api.sletat.ru:443/hotel-rooms-service/rooms/data/46066

Параметры запроса:

Пример ответа (для удобства чтения данные представлены только по одному номеру)

{
   "result": [
       {
           "id": 40905,
           "name": "Двухместный номер с 1 кроватью или 2 отдельными кроватями",
           "lName": null,
           "description": "Двухместный номер с 1 кроватью или 2 отдельными кроватями, балконом, кондиционером и кафельным/мраморным полом.",
           "roomCount": null,
           "defaultPersonCount": null,
           "maxPersonCount": 2,
           "area": 0,
           "isRangeArea": null,
           "minArea": null,
           "maxArea": null,
           "sleepingPlaces": [
               {
                   "id": 53849,
                   "name": null,
                   "isAdditional": false,
                   "isCustom": true,
                   "count": 2,
                   "isExtraCharge": null,
                   "defaultName": "Односпальная кровать"
               }
           ],
           "photos": [
               {
                   "id": 124306,
                   "name": "room_983e9fde-1e4a-4808-81a9-0672f316505e.jpg",
                   "url": "https://storage.yandexcloud.net/slt-hotels-room-storage/room_photos/hotel_46066/room_983e9fde-1e4a-4808-81a9-0672f316505e.jpg",
                   "isTitle": null
               },
               {
                   "id": 124307,
                   "name": "room_88a2d264-2bd5-41f5-9a2a-d112f6d00780.jpg",
                   "url": "https://storage.yandexcloud.net/slt-hotels-room-storage/room_photos/hotel_46066/room_88a2d264-2bd5-41f5-9a2a-d112f6d00780.jpg",
                   "isTitle": null
               },
               {
                   "id": 124308,
                   "name": "room_72d7503d-7cdd-44e8-9e11-4a86d0b980b3.jpg",
                   "url": "https://storage.yandexcloud.net/slt-hotels-room-storage/room_photos/hotel_46066/room_72d7503d-7cdd-44e8-9e11-4a86d0b980b3.jpg",
                   "isTitle": null
               },
               {
                   "id": 124309,
                   "name": "room_a8e98757-4c83-454e-b84b-741a6f77d4d0.jpg",
                   "url": "https://storage.yandexcloud.net/slt-hotels-room-storage/room_photos/hotel_46066/room_a8e98757-4c83-454e-b84b-741a6f77d4d0.jpg",
                   "isTitle": null
               },
               {
                   "id": 124310,
                   "name": "room_d5a48d9d-2729-429b-ae85-242429c94232.jpg",
                   "url": "https://storage.yandexcloud.net/slt-hotels-room-storage/room_photos/hotel_46066/room_d5a48d9d-2729-429b-ae85-242429c94232.jpg",
                   "isTitle": null
               }
           ],
           "facilities": [
               {
                   "id": 13,
                   "name": "Сейф",
                   "groupId": 2,
                   "groupName": "Техническое оснащение",
                   "hit": ""
               },
               {
                   "id": 15,
                   "name": "Телевизор",
                   "groupId": 2,
                   "groupName": "Техническое оснащение",
                   "hit": ""
               },
               {
                   "id": 19,
                   "name": "Косметические наборы",
                   "groupId": 3,
                   "groupName": "Ванна",
                   "hit": ""
               },
               {
                   "id": 22,
                   "name": "Фен",
                   "groupId": 3,
                   "groupName": "Ванна",
                   "hit": ""
               },
               {
                   "id": 37,
                   "name": "Шкаф или гардероб",
                   "groupId": 5,
                   "groupName": "Мебель",
                   "hit": ""
               }
           ]
       },
   ...
   ],
   "error": null
}  

Соответствие полей Name и ID отображены в файле

Модель ответа и пример Id приложены в Swagger.

Ссылка на Swagger с документацией:

https://api.sletat.ru/hotel-rooms-service-docs/index.html