Skip to main content
Pour garantir la stabilité et la disponibilité de l’API pour l’ensemble des marchands, l’API publique de Maketou applique des limites de fréquence (rate limiting) sur certains endpoints.
La création de panier n’est pas soumise aux limites de fréquence. Cet endpoint ne retourne pas les headers X-RateLimit-*, Retry-After ni le code HTTP 429.

​
Les limites

Les limites s’appliquent par clé API selon deux fenêtres complémentaires, auxquelles s’ajoute une protection par adresse IP : Une requête est rejetée dès qu’une seule de ces limites est atteinte. La limite de rafale protège contre les pics de requêtes ; la limite soutenue plafonne le volume sur une minute.

​
Headers de réponse

Les réponses des endpoints soumis aux limites incluent des headers qui indiquent l’état du quota par clé API sur la fenêtre de 60 secondes :

​
Réponse en cas de dépassement

Lorsqu’une limite est dépassée, l’API répond avec le code HTTP 429 Too Many Requests et le header Retry-After :
Retry-After indique le délai (en secondes) à respecter avant de renvoyer une requête.

​
Bonnes pratiques

  • Respectez le header Retry-After : en cas de 429, attendez le délai indiqué avant de réessayer.
  • Mettez en place un backoff : espacez vos tentatives plutôt que de boucler immédiatement après un 429.
  • Surveillez X-RateLimit-Remaining : anticipez l’atteinte de la limite pour lisser votre trafic.
  • Évitez le polling agressif : pour vérifier le statut d’un panier, espacez vos appels (par exemple, toutes les quelques secondes) plutôt que de manière continue, ou privilégiez les webhooks de panier.
  • Ne limitez pas votre tunnel de paiement à cause du checkout : la création de panier n’est pas limitée, même pour un trafic élevé.