Ограничение частоты запросов

Общие лимиты запросов

Для API установлен лимит в 150 запросов каждые 60 секунд. Все запросы учитываются в общем количестве. Каждый запрос, обработанный API, возвращает информацию об ограничении частоты запросов в HTTP-заголовках.

Примечание: Ограничение частоты запросов основано как на имени пользователя, так и на IP-адресе. Поэтому для одного имени пользователя лимит составляет 150 запросов каждые 60 секунд, как и для одного IP-адреса.

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

Для запросов входа установлен лимит в 10 запросов каждые 60 секунд. Все запросы учитываются в общем количестве.

Примечание: IP-адрес и имя пользователя каждого выполненного запроса статистики будут учитываться в рамках этих лимитов.

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

Для запросов статистики установлен лимит в 30 запросов в минуту для каждого IP-адреса и 25 запросов в минуту для каждого имени пользователя.

Примечание: IP-адрес и имя пользователя каждого выполненного запроса статистики будут учитываться в рамках этих лимитов.

Например, если вы войдете в систему под своим именем пользователя на одном компьютере и сделаете 25 запросов статистики, следующий запрос завершится неудачей. Однако вы могли бы сменить имя пользователя и сделать еще 5 запросов статистики, прежде чем достигнете лимита по IP-адресу.

Примеры

Ограничение частоты запросов — пример 1

$ curl -i https://api.example.com/v2/statistics/a/date

{
  "HTTP/1.1": "200 OK",
  "Date": "Fri, 24 Oct 2014 14:57:32 GMT",
  "Content-Type": "application/json",
  "Transfer-Encoding": "chunked",
  "X-Rate-Limit-Limit": 25,
  "X-Rate-Limit-Remaining": 44,
  "X-Rate-Limit-Reset": 27
}

Когда лимит частоты запросов превышен, будет 429 Слишком много запросов HTTP-ошибка будет возвращаться при любых последующих запросах, пока лимит частоты запросов не будет сброшен. Как и при обычном запросе, информация об ограничении частоты запросов будет доступна в HTTP-заголовках.

Ограничение частоты запросов — пример 2 (лимит превышен)

$ curl -i https://api.example.com/v2/statistics/a/date

{
  "HTTP/1.1": "429 Слишком много запросов",
  "Date": "Fri, 24 Oct 2014 15:04:35 GMT",
  "Content-Type": "application/json",
  "Transfer-Encoding": "chunked",
  "X-Rate-Limit-Limit": 25,
  "X-Rate-Limit-Remaining": 0,
  "X-Rate-Limit-Reset": 12
}