Корзины
У приложения своя корзина, у магазина — одна на все его приложения вместе. Запрос берёт по токену из обеих; чтение и запись делят их.
| Корзина | Запросов в минуту | Подряд |
|---|---|---|
| Каждое приложение | 300 | 100 |
| Магазин, все приложения вместе | 1200 | 400 |
«Подряд» — сколько запросов проходит без паузы; дальше корзина пополняется со скоростью в минуту.
Заголовки
Каждый ответ сообщает обе корзины по черновику 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 — в таблице лимитов.