Cómo gestionar una respuesta HTTP 429 sin saturar una API

Lee la respuesta completa

Conserva código, identificador de petición, cabeceras relevantes y operación afectada. Microsoft Graph documenta Retry-After y recomienda esperar ese intervalo; si no aparece, contempla espera exponencial. Otras APIs pueden expresar límites de otra manera, por lo que debes revisar su contrato. No trates 429 como un dato inválido ni lo ocultes bajo un error genérico que haga repetir al usuario una solicitud ya pendiente.

Frena a quienes comparten el límite

Averigua si la cuota corresponde a aplicación, cuenta, recurso u otro ámbito. Si diez trabajadores siguen enviando mientras uno espera, la regulación local no controla el tráfico agregado. Reduce concurrencia o programa los próximos intentos en una cola compartida. Mantén capacidad para consultas operativas necesarias según las posibilidades del servicio; evita que una importación masiva monopolice el acceso de todos los procesos interactivos.

Evita la recuperación en estampida

Cuando termina la espera, libera trabajo de forma gradual y observa las respuestas. Si vuelven los 429, adapta el ritmo en lugar de vaciar toda la cola. Si el cliente ya incorpora reintentos, comprueba su configuración antes de añadir otra capa. En Graph, una respuesta de lote puede ser globalmente correcta y contener subpeticiones limitadas: inspecciona cada resultado y recupera solo los elementos afectados. Agrupar llamadas no elimina la cuota.

Mide espera y trabajo pendiente

Define una antigüedad máxima operativa y un destino para tareas que la superan. La regulación de tráfico no debe convertir un error temporal en un retraso invisible de días. Ensaya una secuencia de 429 con distintos intervalos y comprueba el calendario real de llamadas, no solo el mensaje del log. Registra cola acumulada, duración de la limitación y volumen por flujo. Si el problema persiste, revisa consultas repetitivas, tamaño del trabajo y alternativas oficiales de extracción antes de aumentar trabajadores.

Fuentes y documentación

• Microsoft Graph: throttling — 429, Retry-After y errores individuales dentro de respuestas de lote.
• Azure Architecture Center: Retry — Distingue fallos transitorios, límites de intentos e impacto de políticas anidadas.