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

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

{

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

}

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

Search API

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

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

Поиск по дополнительным услугам: 10 запросов в секунду, 100 запросов в минуту, 1000 запросов в час.

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