Saltar al contenido principal

Rate Limiting

Límites globales de solicitud​

La API está limitada a 150 solicitudes cada 60 segundos. Todas las solicitudes cuentan para el total. Cada solicitud procesada por la API devuelve información sobre la limitación de velocidad en las cabeceras HTTP.

Nota: La limitación de velocidad 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 solicitud de estadísticas​

Las solicitudes de estadísticas están limitadas a 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 entras con tu nombre de usuario en un solo ordenador y haces 25 peticiones de estadísticas, la siguiente que hagas fallará. Sin embargo, podrías cambiar a otro nombre de usuario y hacer 5 peticiones de estadísticas más, antes de llegar al límite de direcciones IP.

Ejemplos​

Limitación de tarifas - 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 exceda el límite de velocidad, se producirá un error HTTP 429 Too Many Requests en cualquier petición posterior hasta que se restablezca el límite de velocidad. Al igual que con una solicitud normal, la información sobre el límite de velocidad estará disponible en las cabeceras HTTP.

Limitación de tarifas - Ejemplo 2 (Límite superado)​


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

{
        "HTTP/1.1": "429 Too Many Requests",
        "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
    }