Limitación de tasa

Límites generales de solicitudes

La API tiene un límite de 150 solicitudes cada 60 segundos. Todas las solicitudes cuentan para el total. Cada solicitud procesada por la API devuelve información de limitación de tasa en los encabezados HTTP.

Nota: La limitación de tasa se basa tanto en el nombre de usuario como en la dirección IP. Por lo tanto, un solo nombre de usuario está limitado a 150 solicitudes cada 60 segundos, al igual que una sola dirección IP.

Límites de solicitudes de inicio de sesión

Las solicitudes de inicio de sesión tienen un límite de tasa de 10 solicitudes cada 60 segundos. Todas las solicitudes cuentan para el total.

Nota: La IP y el nombre de usuario de cada solicitud de estadísticas realizada contarán para estos límites.

Límites de solicitudes de estadísticas

Las solicitudes de estadísticas tienen un límite de tasa de 30 solicitudes por minuto para cada dirección IP y 25 solicitudes por minuto para cada nombre de usuario.

Nota: La IP y el nombre de usuario de cada solicitud de estadísticas realizada contarán para estos límites.

Por ejemplo, si inicias sesión con tu nombre de usuario en una sola computadora y realizas 25 solicitudes de estadísticas, la siguiente que hagas fallará. Sin embargo, podrías cambiar a un nombre de usuario diferente y hacer 5 solicitudes de estadísticas más, antes de alcanzar el límite de la dirección IP.

Ejemplos

Limitación de tasa - Ejemplo 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
}

Cuando se excede el límite de tasa, se 429 Demasiadas solicitudes lanzará un error HTTP en cualquier solicitud posterior hasta que se restablezca el límite de tasa. Al igual que con una solicitud normal, la información de limitación de tasa estará disponible en los encabezados HTTP.

Limitación de tasa - Ejemplo 2 (Límite excedido)

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

{
  "HTTP/1.1": "429 Demasiadas solicitudes",
  "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
}