Запросы используют единое скользящее 60-секундное окно аккаунта для всех ключей. Уровень аккаунта определяется сохранёнными успешными расходами за всё время; ограничения по IP и действию могут отклонить запрос раньше или отдельно. Почасовой квоты и квоты на отдельный ключ нет.
20 000 запросов / минуту / IP-адресПрименяется до проверки ключа, чтобы ограничить перебор ключей грубой силой. Общий для всех ключей за одним IP. Значение по умолчанию задаётся глобально и не настраивается пользователем.
120–2 400 запросов / скользящие 60 секундВсе активные API-ключи аккаунта используют один счётчик. Лимит задаёт фиксированная шкала успешных расходов за всё время, если администратор не установил индивидуальный RPM.
Зависит от действияДля некоторых чувствительных действий действует более узкий лимит аккаунта. Например, cancel допускает 30 запросов в минуту на аккаунт; его ответ 429 сообщает action.
Учитываются сохранённые успешные расходы за всё время жизни аккаунта. Полная и частичная доставка добавляет сохранённую успешную сумму, а последующие возвраты уменьшают её. Действующий лимит обновляется по сохранённому итогу без ежедневной задачи. Используйте action=account_status, чтобы получить заработанный уровень и действующий RPM.
| Уровень | Минимальные расходы за всё время | Запросов / минуту |
|---|---|---|
| 0 | $0.00000000 | 120 |
| 1 | $10.00000000 | 300 |
| 2 | $50.00000000 | 600 |
| 3 | $100.00000000 | 900 |
| 4 | $500.00000000 | 1,200 |
| 5 | $1000.00000000 | 1,800 |
| 6 | $2500.00000000 | 2,400 |
| Заголовок | Описание |
|---|---|
| X-RateLimit-Limit | В обычном ответе — действующий общий лимит запросов аккаунта в минуту. В ответе 429 — лимит отклонившего слоя. |
| X-RateLimit-Remaining | В обычном ответе — число запросов, оставшихся в общем окне аккаунта. В ответе 429 — остаток отклонившего слоя. |
| X-RateLimit-Reset | Относительное число секунд до сброса указанного окна; это не Unix timestamp. |
| X-RateLimit-Tier | Уровень, полученный за успешные расходы за всё время (0–6). Индивидуальный лимит RPM не меняет это значение. |
| X-RateLimit-Source | "tier", когда действующий RPM задаётся фиксированной шкалой; "custom", когда он задан администратором напрямую. |
| X-RateLimit-DeniedBy | Передаётся в ответе 429, когда запрос отклоняет именованный ограничитель: "ip", "api_requests_per_minute" или "action". |
| Retry-After | При повторяемом ответе 429 или 503 подождите перед повтором не меньше числа секунд из Retry-After. Для action=add после ожидания используйте тот же ключ идемпотентности. |
ip, api_requests_per_minute и action указывают отклонивший слой; смена ключа не обходит общий лимит аккаунта, IP или действия.action=status.