Rate limits

Límites de tasa de la API de Falconext y cómo manejarlos.

La API aplica límites de tasa para proteger el servicio. Los valores son ilustrativos; consulta tu plan en la consola para los límites vigentes.

Recurso	Límite	Ventana
Lectura (`GET`)	600 req	por minuto
Escritura (`POST`, `PUT`, `PATCH`, `DELETE`)	120 req	por minuto
Webhooks entrantes	sin límite	—

Cabeceras de límite

Cada respuesta incluye tu estado actual de cuota:

HTTP

RateLimit-Limit: 120
RateLimit-Remaining: 118
RateLimit-Reset: 43

Cuando superas el límite

Recibirás 429 Too Many Requests. Respeta la cabecera Retry-After (en segundos):

JSON

{
  "error": {
    "type": "rate_limit_error",
    "code": "too_many_requests",
    "message": "Superaste el límite de solicitudes. Reintenta en 43 segundos."
  }
}

Reintenta con backoff exponencial

Implementa reintentos con jitter: espera Retry-After, y ante errores 5xx duplica el tiempo entre intentos (1s, 2s, 4s…) hasta un máximo razonable.

Buenas prácticas

Usa webhooks en vez de polling para conocer el estado de los pedidos.
Agrupa operaciones y evita ráfagas innecesarias.
Cachea respuestas que no cambian con frecuencia.