Rate limits et codes d'erreur

3 min de lecture · API et intégrations

Les rate limits empêchent l'abus de l'API. En cas de dépassement, vous recevez un HTTP 429 avec l'en-tête Retry-After.

Limites selon le plan

Trial / Standard : 60 requêtes / minute Profi : 300 requêtes / minute Business : 1000 requêtes / minute La limite est par token, pas par utilisateur (vous pouvez avoir plusieurs tokens pour différents cas d'usage).

Codes d'erreur

- 401 Unauthorized : token manquant ou invalide - 403 Forbidden : le token n'a pas les droits pour cette action (token en lecture seule sur un endpoint d'écriture) - 404 Not Found : la ressource n'existe pas - 429 Too Many Requests : rate limit dépassé, attendez Retry-After secondes - 5xx : erreur serveur, retry avec backoff exponentiel

Bonnes pratiques

- Cachez les responses pour la lecture (les données d'uptime ne changent pas chaque seconde) - Utilisez les webhooks au lieu du polling lorsque c'est possible - Lors des opérations batch, utilisez un délai entre les requêtes