Limites de débit - Chataigne Docs

L’API Chataigne autorise actuellement 10 000 requêtes par tranche de 60 secondes pour chaque clé API. Cette limite protège la disponibilité du service et empêche une intégration de le surcharger.

En-têtes de réponse

Chaque réponse indique l’état actuel de la limite de la clé :

En-tête	Signification
`X-RateLimit-Limit`	Nombre maximal de requêtes dans la période actuelle.
`X-RateLimit-Remaining`	Nombre de requêtes restantes dans la période actuelle.
`X-RateLimit-Reset`	Moment auquel la période actuelle est réinitialisée.

Utilisez ces en-têtes pour la supervision et pour ralentir les traitements volumineux avant d’épuiser le quota.

Lorsque la limite est dépassée

L’API renvoie 429 Too Many Requests avec un corps rate_limit_error et un en-tête Retry-After. Ne retentez pas la requête avant l’expiration de ce délai.

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0

Réessayer en toute sécurité

Respectez Retry-After lorsqu’il est présent.
Ajoutez un petit délai aléatoire pour éviter que plusieurs processus retentent au même instant.
Limitez le nombre de tentatives.
Utilisez les clés d’idempotence lorsque vous retentez une création de ressource.
Réduisez la concurrence des imports par lots et utilisez une taille de pagination adaptée.

Node.js

async function fetchWithRateLimitRetry(url, options, attempts = 4) {
  for (let attempt = 0; attempt < attempts; attempt += 1) {
    const response = await fetch(url, options);
    if (response.status !== 429) return response;

    const retryAfter = Number(response.headers.get('retry-after') ?? 1);
    const jitterMs = Math.floor(Math.random() * 250);
    await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000 + jitterMs));
  }
  throw new Error('Nombre maximal de nouvelles tentatives atteint');
}

Les limites peuvent évoluer. Lisez les en-têtes de réponse au lieu d’inscrire le quota actuel en dur dans la logique de votre application.

​En-têtes de réponse

​Lorsque la limite est dépassée

​Réessayer en toute sécurité

En-têtes de réponse

Lorsque la limite est dépassée

Réessayer en toute sécurité