Rate limits et codes d'erreur

La limite de requêtes (rate limit) protège l'API contre la surcharge et les abus. Si vous envoyez trop de requêtes en peu de temps, le serveur renverra une réponse HTTP 429 Too Many Requests avec l'en-tête Retry-After, qui indique combien de secondes il faut attendre.

Limites actuelles

• La limite est de 60 requêtes par minute pour chaque token. Elle s'applique de la même façon à toutes les formules (Trial, Standard, Profi et Business).
• Les agents LAN disposent d'une limite distincte de 120 requêtes par minute par agent.
• La limite est calculée pour chaque token séparément (et non pour l'utilisateur entier). Si vous avez besoin d'un plafond global plus élevé, créez plusieurs tokens pour différents usages (par exemple un token dédié pour la CI/CD et un autre pour le dashboard).

Codes d'erreur

• 401 Unauthorized - token manquant ou non valide.
• 403 Forbidden - l'action n'est pas disponible dans votre forfait (par exemple la création d'un moniteur après l'expiration du forfait ou au-delà de la limite de votre forfait).
• 404 Not Found - la ressource (moniteur, incident) n'existe pas ou vous n'y avez pas accès.
• 429 Too Many Requests - limite de requêtes dépassée. Attendez le nombre de secondes indiqué dans l'en-tête Retry-After.
• 5xx - erreur côté serveur. Réessayez avec un délai qui s'allonge progressivement (exponential backoff - par exemple 1, 2, 4, 8 secondes).

Recommandations pratiques

• Mettez en cache les réponses des endpoints de lecture. Les données de disponibilité ne changent pas à chaque seconde, vous n'avez donc pas besoin de les récupérer aussi souvent.
• Quand c'est possible, à la place du polling répété, utilisez des webhooks - le serveur vous appellera de lui-même lorsqu'un événement se produira.
• Pour les opérations par lots, ajoutez un court délai entre les requêtes afin de ne pas vous approcher de la limite.