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

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

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

Поле	Тип	Обязательно	Описание
`hotelId`	string	Да	Идентификатор отеля
`checkin`	date	Да	Дата заезда (формат: YYYY-MM-DD)
`checkout`	date	Да	Дата выезда (формат: YYYY-MM-DD)
`currency`	string	Да	Валюта цен (ISO 4217)
`language`	string	Да	Язык ответа (например `ru`, `en`)
`onlyAvailableOffers`	boolean	Да	Показывать только доступные предложения
`guests`	Guests	Да	Конфигурация гостей
`residency`	string	Нет	Резидентство гостя (ISO 3166-1 alpha-2, например `RU`)
`earlyCheckin`	time	Нет	Желаемое время раннего заезда (формат HH:mm)
`lateCheckout`	time	Нет	Желаемое время позднего выезда (формат HH:mm)
`paymentTypes`	string[]	Нет	Фильтр по типам оплаты (`hotel`, `online`)
`searchTags`	string[]	Нет	Теги поиска
`pricingTags`	string[]	Нет	Теги прайсинга

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

Базовый запрос#

 1{
 2  "hotelId": "hotel-001",
 3  "checkin": "2025-12-15",
 4  "checkout": "2025-12-18",
 5  "currency": "RUB",
 6  "language": "ru",
 7  "onlyAvailableOffers": true,
 8  "guests": {
 9    "adults": 2
10  }
11}

С ранним заездом и поздним выездом#

Укажите earlyCheckin и lateCheckout для получения опций:

 1{
 2  "hotelId": "hotel-001",
 3  "checkin": "2025-12-15",
 4  "checkout": "2025-12-18",
 5  "currency": "RUB",
 6  "language": "ru",
 7  "onlyAvailableOffers": true,
 8  "earlyCheckin": "10:00",
 9  "lateCheckout": "18:00",
10  "guests": {
11    "adults": 2
12  }
13}

С указанием резидентства#

Некоторые отели предлагают разные цены в зависимости от резидентства:

 1{
 2  "hotelId": "hotel-001",
 3  "checkin": "2025-12-15",
 4  "checkout": "2025-12-18",
 5  "currency": "RUB",
 6  "language": "ru",
 7  "onlyAvailableOffers": true,
 8  "residency": "RU",
 9  "guests": {
10    "adults": 2
11  }
12}

Только онлайн-оплата#

 1{
 2  "hotelId": "hotel-001",
 3  "checkin": "2025-12-15",
 4  "checkout": "2025-12-18",
 5  "currency": "RUB",
 6  "language": "ru",
 7  "onlyAvailableOffers": true,
 8  "paymentTypes": ["online"],
 9  "guests": {
10    "adults": 1
11  }
12}

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

Минимальный запрос#

curl

 1curl -X POST https://test.travel-api.ru/hotels/hotel_pricing \
 2  -H "Authorization: Bearer YOUR_TOKEN" \
 3  -H "Content-Type: application/json" \
 4  -d '{
 5    "hotelId": "hotel-001",
 6    "checkin": "2025-12-15",
 7    "checkout": "2025-12-18",
 8    "currency": "RUB",
 9    "language": "ru",
10    "onlyAvailableOffers": true,
11    "guests": {
12      "adults": 2
13    }
14  }'

 1var request = new HotelPricingRequest
 2{
 3    HotelId = "hotel-001",
 4    Checkin = new DateOnly(2025, 12, 15),
 5    Checkout = new DateOnly(2025, 12, 18),
 6    Currency = "RUB",
 7    Language = "ru",
 8    OnlyAvailableOffers = true,
 9    Guests = new Guests
10    {
11        Adults = 2
12    }
13};
14
15var response = await httpClient.PostAsJsonAsync(
16    "https://test.travel-api.ru/hotels/hotel_pricing",
17    request
18);
19
20var result = await response.Content.ReadFromJsonAsync<HotelPricingResponse>();

Полный запрос с опциями#

 1{
 2  "hotelId": "hotel-001",
 3  "checkin": "2025-12-15",
 4  "checkout": "2025-12-18",
 5  "currency": "RUB",
 6  "language": "ru",
 7  "onlyAvailableOffers": true,
 8  "residency": "RU",
 9  "earlyCheckin": "10:00",
10  "lateCheckout": "18:00",
11  "paymentTypes": ["online", "hotel"],
12  "guests": {
13    "adults": 2,
14    "children": [
15      { "age": 5 }
16    ]
17  }
18}