Ограничения на честотата
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 секунди и добавете случаен интервал. При повторен запис запазете първоначалния ключ и данни.
- Следвайте документирания код и заглавката, вместо да предполагате фиксиран интервал.