Rate Limit Exceeded 429

El cliente envió demasiadas requests en un período corto. Esperá retry_after_seconds antes de reintentar.

Política de retry: Reintentar con backoff exponencial
type: /api/v1/problems/rate-limit-exceeded

Cuándo se dispara

• Tu token (o IP, si no autenticado) excedió la cuota global (default 200/min) o la cuota más estricta de un endpoint pesado.
• Burst de requests sin honrar el header X-RateLimit-Remaining que devolvemos en cada response.

Para clientes OAuth2

Honrá el header Retry-After (segundos) o X-RateLimit-Reset (epoch) antes de reintentar. Implementá backoff exponencial — un reintento inmediato volverá a fallar.

Para Fracttal One

Mostrá al usuario un mensaje no-bloqueante 'demasiadas requests, reintentando…' y reintentá automáticamente tras Retry-After segundos. Si pasa con frecuencia, revisar polling agresivo en el cliente.

Body de ejemplo

{
  "type": "/api/v1/problems/rate-limit-exceeded",
  "title": "Rate Limit Exceeded",
  "status": 429,
  "detail": "10 per 1 minute",
  "instance": "/api/v1/dags",
  "error_code": "RATE_LIMITED",
  "retry_after_seconds": 60
}

Endpoints donde puede aparecer

• Cualquier endpoint — el límite es global por bucket

Códigos internos asociados

• RATE_LIMITED

Problems relacionados

Ninguno