Перейти к содержимому

Лимиты запросов

На все ваши секретные ключи вместе — 600 запросов в минуту. У публичного ключа два лимита: 60 запросов в минуту с одного IP-адреса и 600 в минуту со всех адресов вместе. Запросы бота и сайта считаются отдельно.

  1. Прочитайте Retry-After в ответе и не отправляйте запросы столько секунд.
  2. Повторите запрос. Если снова 429, увеличивайте паузу.
  3. Снизьте частоту: храните ответ у себя, берите limit побольше, не опрашивайте чаще, чем меняются данные.

Новый ключ лимит не увеличит: секретные ключи делят его между собой. Страница с публичным ключом исчерпывает лимит, если запрашивает данные слишком часто: обновляйте их не чаще раза в 30 секунд.

В ответе на запрос с действующим ключом есть два заголовка:

RateLimit-Policy: "app-user";q=600;w=60, "app";q=6000;w=60, "user";q=1200;w=60
RateLimit: "app-user";r=599;t=42, "app";r=5999;t=42, "user";r=1199;t=42

q — лимит на окно, 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.