Qué gatilla un 429, cómo se cuenta el cupo y qué hacer al recibirlo.
Qué pasa cuando llamas a la API más seguido de lo permitido.
Algunos endpoints limitan cuántas llamadas aceptan por intervalo de tiempo. Al superar ese límite, la API responde 429 Too Many Requests y descarta la petición sin procesarla: nada se creó ni se modificó, y puedes volver a enviarla más adelante.
Cómo se cuenta
El cupo es por credencial, no por dirección IP: cada API Key —o cada cliente OAuth— tiene el suyo, y lo que consume una no le quita cupo a otra. Repartir las llamadas entre varios servidores no agranda el cupo si todos usan la misma credencial; separarlo exige credenciales distintas.
Una petición sin credencial válida no alcanza a contarse: se rechaza antes, con 401. Ver Autenticación.
Qué hacer cuando recibes un 429
429- Espera antes de reintentar, con backoff exponencial. Sube el tiempo de espera en cada intento (1 s, 2 s, 4 s, etc.).
- No reintentes en paralelo. Lanzar los reintentos de golpe reproduce el mismo
429que los provocó. - Un
429sostenido no se resuelve reintentando. Si el límite te queda chico para tu caso de uso, escríbenos.
El significado de cada status, incluido el 429, vive en Códigos HTTP de respuesta.