Лимиты на запросы и список ошибок в 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 запросов в секунду. Если за 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	Ошибка авторизации	Не передан API-ключ. Передан недействительный API-ключ. Время жизни сессии истекло.
403	Нет прав для данной операции	Необходимо проверить настройки прав для приложения. Введен недопустимый код объекта размещения для тестирования.
404	Запрашиваемый объект не найден	Возможно, объект удален или указан неверный id объекта.
429	Превышен лимит запросов к API	Клиентское приложение превысило предел скорости или количество запросов, которые они могут отправить за определенный период времени.
500	Внутренняя ошибка сервера	Внутренняя ошибка сервера. Попробуйте вызвать метод через некоторое время. При повторении ошибки обратитесь в службу технической поддержки: support@travelline.ru.

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

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