Respuestas

Encabezados

Todas las respuestas se devuelven en formato JSON. Lo especificamos enviando la cabecera Content-Type.

Ejemplo de respuesta:

HTTP/1.1 200 OK
Content-Type: application/json
{
    "success": "true",
}

Códigos de estado

Todas las respuestas fallidas contendrán una respuesta JSON con "error" establecido en true y un mensaje de error.

Ejemplo de respuesta de una solicitud fallida:

HTTP/1.1 400 Bad request
Content-Type: application/json
{
    "error": "true",
    "message": "Some error message", 
}

Límites de tasa

Todas las llamadas dentro de la API Web tienen asignado un número específico de peticiones por periodo de actualización.

Dependiendo del punto que estés intentando alcanzar, tendrás un número específico de peticiones permitidas por periodo de actualización. Una vez alcanzado este umbral, devolveremos una respuesta con código de estado 429.

Cada respuesta de la API contiene cabeceras X-RateLimit que informan sobre su límite actual.

Ejemplo de respuesta:

HTTP/1.1 200 OK
Content-Type: application/json
X-RateLimit-Limit: 180
X-RateLimit-Remaining: 179
X-RateLimit-Reset: 60
{
  "foo": "bar"
}

Cuando se alcance el límite, ya no podrás realizar peticiones a ese punto durante el periodo de actualización.

Por defecto puedes hacer un mínimo de 180 peticiones por minuto. Esto equivale a 3 peticiones por segundo.