Limitation de débit

Chaque instance applique un quota horaire à son API REST (/api/...) :

• Fenêtre horaire fixe : la fenêtre s'ouvre avec la première requête API et se réinitialise une heure plus tard.
• Pas de quota par client : tous les identifiants API et utilisateurs d'une instance comptent dans le même quota.
• Ce qui est compté : chaque requête à /api/... compte pour un appel, y compris les requêtes qui échouent (par exemple 401 pour un token manquant ou expiré). Une requête par lot compte comme un seul appel. Les requêtes de token (/oauth/v2/token) ne sont pas comptées.
• Pas de limite par seconde : préférez tout de même les endpoints par lot et limitez le nombre de requêtes simultanées.

Lorsque la limitation de débit est activée sur votre instance, les réponses de l'API portent les en-têtes suivants. Lisez le quota depuis X-RateLimit-Limit plutôt que de coder une valeur en dur :

En-tête	Description
X-RateLimit-Limit	Requêtes autorisées dans la fenêtre actuelle
X-RateLimit-Remaining	Requêtes restantes dans la fenêtre actuelle
X-RateLimit-Reset	Sur une réponse 429 : timestamp Unix auquel la fenêtre se réinitialise (sur les autres réponses, elle contient l'heure actuelle)

Lorsque le quota est dépassé, l'API renvoie HTTP 429, sans en-tête Retry-After :

{
  "errors": [
    {
      "code": 429,
      "message": "You exceeded the rate limit of 15000 API calls per hour.",
      "details": []
    }
  ]
}

Attendez X-RateLimit-Reset avant d'envoyer de nouvelles requêtes — ne réessayez jamais en boucle.