Лимиты запросов
На все ваши секретные ключи вместе — 600 запросов в минуту. У публичного ключа два лимита: 60 запросов в минуту с одного IP-адреса и 600 в минуту со всех адресов вместе. Запросы бота и сайта считаются отдельно.
Что делать после 429
Заголовок раздела «Что делать после 429»- Прочитайте
Retry-Afterв ответе и не отправляйте запросы столько секунд. - Повторите запрос. Если снова
429, увеличивайте паузу. - Снизьте частоту: храните ответ у себя, берите
limitпобольше, не опрашивайте чаще, чем меняются данные.
Новый ключ лимит не увеличит: секретные ключи делят его между собой. Страница с публичным ключом исчерпывает лимит, если запрашивает данные слишком часто: обновляйте их не чаще раза в 30 секунд.
Как узнать остаток
Заголовок раздела «Как узнать остаток»В ответе на запрос с действующим ключом есть два заголовка:
RateLimit-Policy: "app-user";q=600;w=60, "app";q=6000;w=60, "user";q=1200;w=60RateLimit: "app-user";r=599;t=42, "app";r=5999;t=42, "user";r=1199;t=42q — лимит на окно, w — длина окна в секундах, r — сколько запросов осталось, t — через сколько секунд
окно начнётся заново. В ответе 429 заголовок Retry-After говорит, через сколько секунд можно повторить запрос,
а поле policy — какой лимит исчерпан:
Название (policy) |
Что ограничивает | В минуту |
|---|---|---|
app-user |
все ваши секретные ключи вместе; отдельно — публичный ключ со всех адресов | 600 |
publishable-ip |
публичный ключ с одного IP-адреса | 60 |
В заголовках есть ещё user (1200) и app (6000): у ваших ключей они не срабатывают раньше app-user.
В ответах без действующего ключа (401, wrong_token_type, token_in_query, origin_not_allowed)
этих заголовков нет.
Ошибка: rate_limited.