Ограничения частоты и кэширование

Сколько запросов можно отправлять, какие заголовки об этом сообщают и что кэшировать.

120 запросов в минуту

С каждого адреса можно отправлять в публичный API 120 запросов в минуту. Счёт начинается заново в начале каждой минуты по часам; сколько секунд до этого осталось, показывает RateLimit-Reset.

Заголовки, показывающие ваш расход

Каждый ответ содержит RateLimit-Limit — сколько запросов допускает окно; RateLimit-Remaining — сколько осталось; и RateLimit-Reset — сколько секунд осталось до начала нового окна.

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 116
RateLimit-Reset: 20

Если вы превысили лимит

Запрос сверх лимита отвечает 429 rate_limited с заголовком Retry-After в секундах. Подождите указанное время перед следующим запросом; новые запросы в это время не сокращают ожидание.

HTTP

HTTP/1.1 429 Too Many Requests
Retry-After: 37

{
  "statusCode": 429,
  "code": "rate_limited",
  "message": "Too many requests. Wait and try again."
}

Храните копию

Данные каталога меняются не чаще нескольких раз в день. Сохраняйте нужные ответы и обновляйте их по расписанию, а не запрашивайте заново для каждого посетителя. Некоторые ответы содержат заголовок Cache-Control, который указывает, как долго они остаются актуальными.