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

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

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

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

Структура BookingSummary#

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

BookingStatus#

Изменение значений. Было: Unknown, Inwork, Booked, Rejected, Cancelled, Error. Станет — тот же фиксированный набор, что в /api/hotels/view_booking и /api/hotels/create_booking:

Значение	Описание
`unknown`	Статус неизвестен
`inWork`	Бронирование в обработке
`completed`	Бронирование подтверждено
`rejected`	Бронирование отклонено
`cancelled`	Бронирование отменено
`failed`	Ошибка при бронировании

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

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

 1{
 2  "bookings": [
 3    {
 4      "bookingId": "019a0c82-5d2b-7a5e-84fe-56357a57df66",
 5      "supplierBookingNumber": "SUP-12345",
 6      "partnerOrderId": "ORDER-12345",
 7      "status": "completed",
 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`	Адаптер поставщика отклонил запрос на этапе валидации	Проверьте параметры запроса
`VALIDATION_ERROR`	Ошибка валидации запроса (HTTP 400)	Проверьте обязательные поля и форматы значений
`NO_TARGETS`	Под запрос не нашлось ни одного поставщика: ни один не настроен либо все отсеяны на этапе подготовки запроса	Проверьте настройки офисов и пресетов в личном кабинете; при сохранении ошибки обратитесь в поддержку
`SUPPLIER_ERROR`	Поставщик вернул ошибку. Причина — текстом поставщика в поле `message`	Разберите `message`; при необходимости повторите запрос позже
`SYSTEM_ERROR`	Внутренняя ошибка Travel API	Повторите запрос позже; при повторении обратитесь в поддержку с `errorId`

Помимо перечисленных TAPI-кодов, при ошибке на стороне поставщика в ответе может быть возвращён код ошибки поставщика без изменений (проброс) — набор таких кодов зависит от поставщика и не фиксирован.