API
Limites de débit
Comprendre les limites de requêtes API et comment les gérer.
Limites de débit
Limites par forfait
| Forfait | Requêtes/minute | Requêtes/jour |
|---|---|---|
| Pro | 60 | 10 000 |
| Enterprise | 300 | 100 000 |
Le forfait Starter n'inclut pas l'accès API.
Headers de réponse
Chaque réponse API contient des headers indiquant votre consommation :
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1710510600| Header | Description |
|---|---|
X-RateLimit-Limit | Limite de requêtes par minute |
X-RateLimit-Remaining | Requêtes restantes |
X-RateLimit-Reset | Timestamp UNIX de réinitialisation |
Dépassement
Si vous dépassez la limite, vous recevez une réponse 429 Too Many Requests :
{
"error": "rate_limit_exceeded",
"message": "Limite de débit atteinte. Réessayez dans 23 secondes.",
"retry_after": 23
}Bonnes pratiques
- Implémentez un backoff exponentiel en cas de 429
- Mettez en cache les réponses qui changent rarement
- Utilisez les webhooks plutôt que le polling
- Regroupez les opérations avec l'import en masse