Passer au contenu principal
L’API Chariow implémente une limitation de débit pour garantir une utilisation équitable et maintenir la qualité du service pour tous les utilisateurs.

Limites par défaut

Chaque clé API a ses propres compteurs : une intégration ne peut donc pas en ralentir une autre derrière la même adresse IP. Le paiement a son propre compteur afin qu’une intégration qui synchronise les ventes ou les produits ne puisse jamais épuiser le budget de la clé et empêcher les acheteurs de payer. Une clé peut donc envoyer jusqu’à 100 requêtes de paiement et 100 autres requêtes dans la même minute. Chaque requête est comptée, y compris celles rejetées avec 401 ou 403.
Le serveur MCP a ses propres limites : 60 requêtes par minute par connexion MCP. Consultez Outils MCP.

En-têtes de limite de débit

Chaque réponse soumise à la limitation inclut des en-têtes indiquant votre statut actuel :
Lorsque vous dépassez la limite, la réponse 429 ajoute deux en-têtes :

Limite de débit dépassée

Lorsque vous dépassez la limite de débit, vous recevez une réponse 429 Too Many Requests :
Attendez le nombre de secondes indiqué dans l’en-tête Retry-After avant d’envoyer la requête suivante.

Gérer les limites de débit

Backoff exponentiel

Implémentez un backoff exponentiel pour gérer les limites de débit, et ne réessayez jamais avant la fin du délai Retry-After :

Regroupement des requêtes

Regroupez plusieurs opérations pour réduire le nombre de requêtes :

Mise en cache

Mettez en cache les réponses pour éviter les requêtes inutiles :

Augmenter les limites

Si vous avez besoin de limites de débit plus élevées :
  1. Optimiser l’utilisation - Examinez votre implémentation : la pagination, le cache et les webhooks suppriment l’essentiel du polling
  2. Contacter le support - Expliquez votre cas d’utilisation et le volume attendu
Contactez support@chariow.com pour discuter de limites de débit plus élevées pour votre cas d’utilisation.

Bonnes pratiques

Suivez les en-têtes de limite de débit pour comprendre vos schémas d’utilisation et ajustez en conséquence.
Au lieu de faire du polling pour les changements, utilisez les webhooks pour recevoir des notifications en temps réel.
Mettez les requêtes en file d’attente et traitez-les à un rythme contrôlé pour éviter les pics.
Mettez en cache les données qui ne changent pas fréquemment pour réduire les appels API.