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

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

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

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

Структура BookingSummary#

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

BookingStatus#

Значение	Описание
`Unknown`	Статус неизвестен
`Inwork`	Бронирование в обработке
`Booked`	Бронирование подтверждено
`Rejected`	Бронирование отклонено
`Cancelled`	Бронирование отменено
`Error`	Ошибка при бронировании

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

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

 1{
 2  "bookings": [
 3    {
 4      "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
 5      "supplierBookingNumber": "SUP-12345",
 6      "partnerOrderId": "ORDER-12345",
 7      "status": "Booked",
 8      "createdAt": "2025-11-20T10:30:00+00:00",
 9      "checkinAt": "2025-12-15",
10      "reservationKey": "RES-ABC"
11    },
12    {
13      "bookingId": "029b1d93-6e3c-8b6f-95gf-67468b68eg77",
14      "supplierBookingNumber": "SUP-67890",
15      "partnerOrderId": "ORDER-67890",
16      "status": "Cancelled",
17      "createdAt": "2025-11-18T14:20:00+00:00",
18      "checkinAt": "2025-12-20"
19    }
20  ]
21}

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

1{
2  "bookings": []
3}

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

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

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

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