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

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

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

ПолеТипОбязательноОписание
supplierOrderIdsstring[]ДаИдентификаторы заказов поставщика для поиска
languagestringДаЯзык ответа (например ru, en)
partnerOrderIdsstring[]НетФильтр по идентификаторам заказов партнера
createdFromdateНетНачальная дата создания (формат: YYYY-MM-DD)
createdTodateНетКонечная дата создания (формат: YYYY-MM-DD)
statusFilterBookingStatusFilterНетФильтр по статусу (по умолчанию 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}

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

 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>();