Обмеження частоти запитів
Engine ≥ 4.143.0. Кожна відповідь із токеном містить data.rate_limits з політики магазину на момент видачі. Усі ключі спільно використовують ці ліміти; новий токен їх не скидає. Зміна плану може діяти до завершення строку токена.
- read_per_minute
- Запити читання за хвилину.
- write_per_minute
- Запити запису за хвилину; це значення не надає прав запису.
- auth_per_minute
- Запити токена за хвилину, включно з невдалими спробами автентифікації.
Розподіляйте запити рівномірно; за додатного ліміту читання залишайте щонайменше 60 / read_per_minute секунд між читаннями. Ліміт не гарантує стільки одночасних запитів. Його використовують інші інтеграції: обробляйте 429 і Retry-After.
Нуль означає недоступність, а не відсутність обмежень.
Ліміти за хвилину
| Доступно починаючи з | Читання · GET |
|---|---|
| BASIC | 60 |
| STANDARD | 120 |
| PROFESSIONAL | 300 |
| ADVANCED | 900 |
- Запис
- 10
- Автентифікація
- 10
Ці ліміти спільні для всіх ключів одного магазину.
Запит
- Запити читання й запису підпорядковуються поточній політиці API магазину.
- Окремі ключі не надають необмежених незалежних ресурсів.
- Обмежуйте кількість одночасних запитів, за потреби кешуйте довідкові дані й уникайте повторного отримання незмінених записів.
429 · Retry-After
- Якщо API повертає 429 із rate_limit.exceeded, зачекайте щонайменше стільки секунд, скільки вказано в Retry-After, і додайте випадкову затримку перед повтором.
- 429 · capacity.queue_full — Коротка черга API заповнена; виконання запиту не розпочалося. 429 · capacity.wait_timeout — Час очікування в черзі API минув; виконання запиту не розпочалося. Зачекайте щонайменше Retry-After секунд і додайте випадкову затримку. Повторюючи запис, зберігайте початковий ключ і дані.
- Використовуйте задокументований код і заголовок замість припущень про фіксований інтервал повторення.