Разделы и статьи

Лимиты на запросы и список ошибок в Partner API

Partner API имеет ограничения на количество запросов. Если лимит запросов будет исчерпан, API покажет код ошибки 429 и json в таком формате:

{

"message": "%описание%"

}

Ниже представлены базовые лимиты, которые могут быть пересмотрены в индивидуальном порядке, — все зависит от роста числа бронирований:

 

Search API

Агрегационный поиск: 3 запроса в секунду, 20 запросов в минуту, 900 запросов в час.

Поиск по отелю: 50 запросов в секунду, 200 запросов в минуту, 1000 запросов в час.

 

Reservation API

Verify: 10 запросов в секунду, 15 запросов в минуту, 100 запросов в час.

Created: 10 запросов в секунду, 15 запросов в минуту, 100 запросов в час.

Cancel: 5 запросов в секунду, 10 запросов в минуту, 50 запросов в час.

CalculatePenalty: 10 запросов в секунду, 15 запросов в минуту, 100 запросов в час

Read: 50 запросов в секунду, 500 запросов в минуту, 5000 запросов в час.

 

Content API

На все API: 50 запросов в секунду, 200 запросов в минуту, 3000 запросов в час.

 

Geo API

На все API: 50 запросов в секунду, 1000 запросов в минуту, 5000 запросов в час.

Например, установлено ограничение по поиску отелей в Search API — 50 запросов в секунду. Если за одну секунду пришел 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

Ошибка авторизации

  • Не передан API-ключ.

  • Передан недействительный API-ключ.

  • Время жизни сессии истекло.

403

Нет прав для данной операции

  • Необходимо проверить настройки прав для приложения.

  • Введен недопустимый код объекта размещения для тестирования.

404

Запрашиваемый объект не найден

Возможно, объект удален или указан неверный id объекта.

429

Превышен лимит запросов к API

Клиентское приложение превысило предел скорости или количество запросов, которые они могут отправить за определенный период времени.

500

Внутренняя ошибка сервера

Внутренняя ошибка сервера. Попробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу технической поддержки: support@travelline.ru.


Обратиться в техподдержку TravelLine

Если у вас остались вопросы, вы всегда можете связаться со специалистами технической поддержки.
Позвоните нам по телефону или задайте интересующий вас вопрос прямо сейчас.