Límites de peticiones
Ventanas fijas por minuto, por key. Los límites protegen tu proyecto y hacen predecible el servicio.
Límite por key
Cada key dispone de 120 peticiones por minuto. Al superarlo, las peticiones responden 429 hasta que la ventana se renueva. Además, los intentos de autenticación fallidos se limitan por IP (20 por minuto) para frenar la fuerza bruta de tokens.
Cabeceras
Las respuestas correctas incluyen el estado de tu ventana: X-RateLimit-Limit (el techo) y X-RateLimit-Remaining (lo que te queda). Úsalas para autorregular integraciones que hacen ráfagas.
Reintentos
El 429 llega con la cabecera Retry-After en segundos y el mismo dato en el cuerpo. Respétala antes de reintentar; para trabajos por lotes, un backoff simple sobre ese valor es suficiente.
429 Too Many Requests
Retry-After: 42
{
"error": {
"code": "rate_limited",
"message": "Límite de peticiones alcanzado. Reintenta más tarde.",
"retryAfterSeconds": 42
}
}