Límites de tarifas

La API Annie Insights impone límites de tarifas para garantizar un uso justo y la estabilidad del sistema.

Límites por tipo de clave

Tipo de clave	Límite de tarifa	Explosión	Límite diario
Salvadera	10 solicitudes/min	5 concurrentes	500/día
Producción	Costumbre	Costumbre	Costumbre

Encabezados de límite de tasa

Cada respuesta de API incluye información de límite de velocidad en los encabezados:

Encabezamiento	Descripción
X-RateLimit-Limit	Solicitudes máximas permitidas en la ventana actual
X-RateLimit-Remaining	Solicitudes restantes en la ventana actual
X-RateLimit-Reset	Marca de tiempo de Unix cuando la ventana se reinicia
Retry-After	Segundos de espera antes de volver a intentarlo (solo en 429)

Límites de tasa de manejo

Cuando excede el límite de velocidad, la API devuelve HTTP 429:

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Retry after 60 seconds.",
  "statusCode": 429
}

Mejores prácticas

1. Supervisar encabezados: verifique X-RateLimit-Remaining antes de enviar solicitudes
2. Solicitudes en cola: implemente una cola de solicitudes con rendimiento controlado
3. Retroceso exponencial: en 429, espere "2^intento" segundos antes de volver a intentarlo.
4. Comuníquese con ventas: para límites más altos, comuníquese con api-support@hcds.ai