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

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

## Что делать после 429

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](https://developers.donatty.com/errors/rate_limited.md).
