Límites de velocidad
Comportamiento de la limitación de velocidad
La API aplica límites de uso para proteger la estabilidad y la equidad. Cuando se superan los límites, la API responde con 429 y contiene indicaciones de reintento.
Comportamiento de los encabezados (exacto)
| Caso | Encabezados devueltos |
|---|---|
| Respuestas autenticadas normales (2xx/4xx comme 422) | X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset |
429 rate_limit_exceeded (quota quotidien/mensuel) | X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After |
429 rps_limit_exceeded / 429 abuse_penalty_active | Retry-After (los campos JSON propios de RPS están en el cuerpo) |
| Respuesta idempotente repetida | Idempotency-Replayed: true |
Tipos de errores 429
| error | Significado | Acción a realizar |
|---|---|---|
| rps_limit_exceeded | Se superó el límite de solicitudes por segundo. | Espera Retry-After y reintenta con retraso aleatorio. El JSON incluye retry_after_ms, backoff_hint, tier_rps_limit, penalty_active. |
| abuse_penalty_active | Hay una ventana de penalización temporal activa después de ráfagas repetidas. | No lances reintentos en bucle; espera toda la ventana de penalización. |
| rate_limit_exceeded | Se alcanzó la cuota del plan/día/mes. | Espera el reinicio de cuota o sube a un plan superior. |
| idempotency_key_reused | La misma Idempotency-Key se reutilizó con un método, un path, una query o un cuerpo diferente. | Genera una nueva clave para la nueva operación. El estado HTTP es 409. |
| request_in_progress | Una solicitud correspondiente con la misma clave sigue en curso. | Espera Retry-After y reintenta con la misma clave. El estado HTTP es 409. |
Reintentos seguros con Idempotency-Key
Las solicitudes astrológicas POST autenticadas y facturables aceptan el encabezado opcional Idempotency-Key: <client-generated unique operation key>. Úsalo cuando reintentes una solicitud que pudo haber expirado después de llegar a la API.
Mismo método, path, query string, cuerpo y clave devuelven la primera respuesta completada con Idempotency-Replayed: true. Las solicitudes repetidas no vuelven a ejecutar el cálculo ni consumen cuota adicional.
Las claves se conservan unas 24 horas. Las solicitudes sin este encabezado mantienen el comportamiento existente sin cambios.
Estrategia recomendada de reintentos del cliente
- Respeta siempre
Retry-Aftersi está presente. - Usa backoff exponencial con jitter completo.
- Retardo base:
250ms, retardo máximo:5s. - Para reintentos
POSTfacturables, reutiliza la mismaIdempotency-Keysolo para exactamente la misma solicitud. - Define un máximo de reintentos para evitar bucles infinitos.
Notas importantes
- No reintentes inmediatamente en un bucle cerrado después de un 429.
- Picos repetidos pueden activar ventanas temporales de bloqueo.
- Los límites del servidor se aplican incluso si existe limitación en el cliente.
Référence
Base URL : https://api.freeastroapi.com
Esta página es el destino devuelto por las respuestas de limitación en el campo docs.