Limites de taux
L'API Annie Insights applique des limites de débit pour garantir une utilisation équitable et la stabilité du système.
Limites par type de clé
| Type de clé | Limite de taux | Éclatement | Casquette quotidienne |
|---|---|---|---|
| Bac à sable | 10 req/min | 5 simultanés | 500/jour |
| Production | Coutume | Coutume | Coutume |
En-têtes de limite de débit
Chaque réponse de l'API inclut des informations sur la limite de débit dans les en-têtes :
| En-tête | Description |
|---|---|
X-RateLimit-Limit | Nombre maximal de requêtes autorisées dans la fenêtre actuelle |
X-RateLimit-Remaining | Demandes restant dans la fenêtre actuelle |
X-RateLimit-Reset | Horodatage Unix lorsque la fenêtre est réinitialisée |
Retry-After | Secondes à attendre avant de réessayer (uniquement sur 429) |
Limites de taux de traitement
Lorsque vous dépassez la limite de débit, l'API renvoie HTTP 429 :
{
"error": "Too Many Requests",
"message": "Rate limit exceeded. Retry after 60 seconds.",
"statusCode": 429
}
Meilleures pratiques
- Surveiller les en-têtes — Vérifiez
X-RateLimit-Remainingavant d'envoyer des requêtes - Demandes de file d'attente : implémentez une file d'attente de requêtes avec un débit contrôlé
- Interruption exponentielle — Sur 429, attendez
2^tentativesecondes avant de réessayer - Contactez le service commercial — Pour des limites plus élevées, contactez api-support@hcds.ai