Limites de débit de l'API

Seau à jetons par clé

Chaque clé d'API dispose d'un seau à jetons avec une rafale de 60 jetons et un taux de recharge de 1 jeton par seconde. Les lectures coûtent 1 jeton. Les écritures coûtent 2 jetons.

La création d'une notification de mise à jour de produit (POST /products/{shopify_product_id}/notifications, simulation comprise) coûte 10 jetons. L'indicateur notify_customers sur une écriture de mapping n'ajoute rien : cette écriture coûte ses 2 jetons habituels, qu'elle demande une notification ou non. La limite de 7 jours d'une notification par produit est une règle distincte avec son propre code, 429 notification_cooldown : son Retry-After peut atteindre sept jours, ne le réessayez donc pas automatiquement — planifiez le prochain appel à error.details.next_available_at.

Une boutique peut aussi avoir au maximum 5 notifications de mise à jour de produit en file d'attente ou en cours d'envoi en même temps. Une sixième donne 429 too_many_active_notifications, un troisième type de 429 à côté de rate_limited et notification_cooldown : distinguez-les donc par error.code, et non par le statut. Il n'a pas de Retry-After : interrogez régulièrement GET /notifications/{id} pour l'un des identifiants de error.details.active_notification_ids et réessayez une fois cette campagne terminée.

Lorsque la limite est dépassée, l'API renvoie 429 rate_limited.

En-têtes de limite de débit

Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 2026-06-05T12:00:00.000Z

Attendez au moins la durée indiquée dans Retry-After avant de réessayer. Réutilisez la même Idempotency-Key lorsque vous réessayez la même écriture.

Limite de renvoi d'e-mails

Le point de terminaison de renvoi de commande dispose d'une limite de sécurité supplémentaire par commande de 3 demandes de renvoi par heure.