Структура ответа#

Детальное описание структуры ответа от /hotels/search_bookings.

Основная структура#

Поле	Тип	Обязательно	Описание
`bookings`	BookingSummary[]	Нет	Список найденных бронирований

Структура BookingSummary#

Поле	Тип	Обязательно	Описание
`supplierBookingNumber`	string	Да	Номер бронирования у поставщика
`partnerOrderId`	string	Да	Идентификатор заказа партнера
`status`	BookingStatus	Да	Статус бронирования
`createdAt`	datetime	Да	Дата создания (ISO 8601)
`checkinAt`	date	Да	Дата заезда (YYYY-MM-DD)
`reservationKey`	string	Нет	Ключ бронирования

BookingStatus#

Значение	Описание
`completed`	Бронирование подтверждено
`cancelled`	Бронирование отменено
`failed`	Ошибка при бронировании

Примеры ответов#

Успешный ответ#

 1{
 2  "bookings": [
 3    {
 4      "supplierBookingNumber": "SUP-12345",
 5      "partnerOrderId": "ORDER-12345",
 6      "status": "Completed",
 7      "createdAt": "2025-11-20T10:30:00+00:00",
 8      "checkinAt": "2025-12-15",
 9      "reservationKey": "RES-ABC"
10    },
11    {
12      "supplierBookingNumber": "SUP-67890",
13      "partnerOrderId": "ORDER-67890",
14      "status": "Cancelled",
15      "createdAt": "2025-11-18T14:20:00+00:00",
16      "checkinAt": "2025-12-20"
17    }
18  ]
19}

Пустой результат#

1{
2  "bookings": []
3}

Ответ с ошибкой#

1{
2  "error": {
3    "code": "VALIDATION_FAILED",
4    "message": "Ошибка валидации",
5    "description": "supplierOrderIds: At least one SupplierOrderId is required",
6    "errorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
7  }
8}

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

Код ошибки	Причина	Решение
`VALIDATION_FAILED`	Ошибка валидации запроса	Проверьте обязательные поля и форматы значений
`SUPPLIER_ERROR`	Поставщик вернул ошибку	Повторите запрос позже
`TIMEOUT`	Превышено время ожидания ответа от поставщика	Повторите запрос позже
`INTERNAL_ERROR`	Внутренняя ошибка сервера	Обратитесь в поддержку