Partner API имеет ограничения на количество запросов. Если лимит запросов будет исчерпан, API покажет код ошибки 429 и json в таком формате:
{
"message": "%описание%"
}
Ниже представлены базовые лимиты, которые могут быть пересмотрены в индивидуальном порядке — все зависит от роста числа бронирований:
Агрегационный поиск: 3 запроса в секунду, 20 запросов в минуту, 900 запросов в час.
Поиск по отелю: 50 запросов в секунду, 200 запросов в минуту, 1000 запросов в час.
Verify: 10 запросов в секунду, 15 запросов в минуту, 100 запросов в час.
Created: 10 запросов в секунду, 15 запросов в минуту, 100 запросов в час.
Cancel: 5 запросов в секунду, 10 запросов в минуту, 50 запросов в час.
CalculatePenalty: 10 запросов в секунду, 15 запросов в минуту, 100 запросов в час
Read: 50 запросов в секунду, 500 запросов в минуту, 5000 запросов в час.
На все API: 50 запросов в секунду, 200 запросов в минуту, 3000 запросов в час.
На все API: 50 запросов в секунду, 1000 запросов в минуту, 5000 запросов в час.
Например, ограничение по поиску отелей в Search API — 50 запросов в секунду. Если за 1 секунду пришел 51-й запрос, то пока эта секунда не закончится все запросы будут возвращаться с ошибкой.
Список кодов и описания ошибок:
HTTP-код | Краткое описание ошибки | Детальное описание ошибки |
200 | Запрос успешно выполнен | Штатный ответ на операцию, ошибок не возникло. |
400 | Некорректный запрос |
|
Incorrect CreateBookingToken | Некорректный запрос. | |
Customer: firstName is required | Необходимо ввести имя клиента. | |
Customer: lastName is required | Необходимо ввести фамилию клиента. | |
Guest: firstName is required | Необходимо ввести имя гостя. | |
Guest: lastName is required | Необходимо ввести фамилию гостя. | |
GuestCount: number of adults not specified | Не указано количество взрослых гостей. | |
ArivalDateTime {ARRIVAL_DATE} should be before departureDateTime {DEPARTURE_DATE} | Время заезда должно быть раньше даты выезда. | |
Start date earlier than the end date | Дата начала проживания должна быть раньше даты окончания. | |
Booking is null | Бронирование недействительно. | |
placement.code {PLACEMENT_CODE} incorrect | Неверный код размещения. | |
BookingOrder: services not supported | Услуги не поддерживаются. | |
BookingOrder: customer is required | Требуется указать клиента. | |
BookingOrder: roomStays not found | Вариант проживания не найден. | |
RoomStay: incorrect guest count, can`t place | Указано неправильное количество гостей. | |
RoomStay: more guests than specified in GuestCount | Указано больше гостей, чем предполагает поле GuestСount | |
Booking: roomStays is required | Необходимо выбрать вариант проживания. | |
RoomStay: stayDates is required | Требуется указать период проживания — дата и время выезда/заезда. | |
RoomStay: ratePlan is required | Требуется указать тарифный план. | |
RoomStay: roomType is required | Требуется указать информацию о категории номера. | |
401 | Ошибка авторизации |
|
403 | Нет прав для данной операции |
|
404 | Запрашиваемый объект не найден | Возможно, объект удален или указан неверный id объекта. |
429 | Превышен лимит запросов к API | Клиентское приложение превысило предел скорости или количество запросов, которые они могут отправить за определенный период времени. |
500 | Внутренняя ошибка сервера | Внутренняя ошибка сервера. Попробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу технической поддержки: support@travelline.ru. |
Если у вас остались вопросы, вы всегда можете связаться со специалистами технической поддержки.
Позвоните нам по телефону или задайте интересующий вас вопрос прямо сейчас.