Поиск бронирований on Travel API - Документация

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

Mon, 01 Jan 0001 00:00:00 +0000

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

Детальное описание всех параметров для запроса /hotels/search_bookings.

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

Поле	Тип	Обязательно	Описание
`supplierOrderIds`	string[]	Да	Идентификаторы заказов поставщика для поиска
`language`	string	Да	Язык ответа (например `ru`, `en`)
`partnerOrderIds`	string[]	Нет	Фильтр по идентификаторам заказов партнера
`createdFrom`	date	Нет	Начальная дата создания (формат: YYYY-MM-DD)
`createdTo`	date	Нет	Конечная дата создания (формат: YYYY-MM-DD)
`statusFilter`	BookingStatusFilter	Нет	Фильтр по статусу (по умолчанию `active`)

BookingStatusFilter#

Значение	Описание
`active`	Только активные бронирования (по умолчанию)
`all`	Все бронирования, включая отмененные

Как использовать параметры#

Все активные бронирования#

1{
2 "supplierOrderIds": ["SUP-001", "SUP-002"],
3 "language": "ru",
4 "statusFilter": "Active"
5}

Поиск по идентификаторам заказов#

1{
2 "supplierOrderIds": ["SUP-001"],
3 "language": "ru",
4 "partnerOrderIds": ["ORDER-12345", "ORDER-67890"]
5}

Поиск по периоду создания#

1{
2 "supplierOrderIds": ["SUP-001", "SUP-002", "SUP-003"],
3 "language": "ru",
4 "createdFrom": "2025-12-01",
5 "createdTo": "2025-12-31",
6 "statusFilter": "All"
7}

Примеры запросов#

curl

 1curl -X POST https://test.travel-api.ru/hotels/search_bookings \
 2 -H "Authorization: Bearer YOUR_TOKEN" \
 3 -H "Content-Type: application/json" \
 4 -d '{
 5 "supplierOrderIds": ["SUP-001", "SUP-002"],
 6 "language": "ru",
 7 "createdFrom": "2025-12-01",
 8 "createdTo": "2025-12-31",
 9 "statusFilter": "Active"
10 }'

 1var request = new SearchBookingsRequest
 2{
 3 SupplierOrderIds = new[] { "SUP-001", "SUP-002" },
 4 Language = "ru",
 5 CreatedFrom = new DateOnly(2025, 12, 1),
 6 CreatedTo = new DateOnly(2025, 12, 31),
 7 StatusFilter = BookingStatusFilter.Active
 8};
 9
10var response = await httpClient.PostAsJsonAsync(
11 "https://test.travel-api.ru/hotels/search_bookings",
12 request
13);
14
15var result = await response.Content.ReadFromJsonAsync<SearchBookingsResponse>();

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

Mon, 01 Jan 0001 00:00:00 +0000

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

Детальное описание структуры ответа от /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`	Внутренняя ошибка сервера	Обратитесь в поддержку