Лимиты запросов

Запросы ограничены сразу двумя корзинами token bucket: приложения и магазина. Каждый ответ говорит, сколько осталось, поэтому интеграция может притормозить раньше, чем получит отказ.

Загружаем поисковый индекс…

Лимиты запросов

Корзины

У приложения своя корзина, у магазина — одна на все его приложения вместе. Запрос берёт по токену из обеих; чтение и запись делят их.

Scale
КорзинаЗапросов в минутуПодряд
Каждое приложение300100
Магазин, все приложения вместе1200400

«Подряд» — сколько запросов проходит без паузы; дальше корзина пополняется со скоростью в минуту.

Заголовки

Каждый ответ сообщает обе корзины по черновику IETF о заголовках RateLimit: RateLimit-Policy называет каждую корзину с квотой на окно, q и w в секундах; RateLimit говорит, сколько запросов осталось подряд, r, и через сколько секунд корзина снова полна, t. Притормаживайте по r, а не ждите отказа.

Что делать на 429

Запрос сверх лимита получает 429 too_many_requests: policy называет исчерпанную корзину, а Retry-After — сколько секунд ждать. Отклонённый запрос не берёт токен из другой корзины.

Запрос
curl "https://api.saleya.app/v1/products?limit=250" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ответ
HTTP/1.1 429 Too Many Requests
Retry-After: 1
RateLimit-Policy: "app";q=300;w=60, "store";q=1200;w=60
RateLimit: "app";r=0;t=20, "store";r=310;t=5

{
  "type": "too_many_requests",
  "title": "Too many requests",
  "status": 429,
  "detail": "The app rate limit is exhausted. Retry after the number of seconds in the Retry-After header.",
  "policy": "app"
}

Запросы, отклонённые на входе, — 401 или 403 неразрешённого адреса и тарифа без API — считаются по адресу, отдельно от корзин. После 60 таких запросов за минуту адрес получает 429 с policy равным rejected до конца минуты. Запросы с действующим токеном в счёт не идут. Исправьте причину, которую назвал ответ 401 или 403, а не повторяйте запрос.

Меньше запросов

  • Тысячи записей — одна массовая операция, а не запрос на запись.
  • Изменения — вебхуки и курсор синхронизации, а не опрос списков.
  • Страницы до 250 записей, а не размера по умолчанию.
  • Несколько интеграций одного магазина делят корзину магазина: разносите тяжёлые задачи по времени.

Остальные потолки и сроки хранения API — в таблице лимитов.

Следующий гайдВерсии API