Limites de débit

Nembol utilise un seau percé (leaky bucket) par clé API (le même modèle que Shopify) : vous pouvez envoyer une rafale jusqu'à la taille du seau, et le seau se vide à un rythme constant.

Partenaires : avec l'en-tête Nembol-Account, chaque entreprise a son propre seau : une entreprise très active ne ralentit donc jamais les autres. Sa taille dépend du plan de cette entreprise, pas du vôtre. Les appels sans l'en-tête (votre propre boutique, /accounts, /partner/*) utilisent le seau de la clé, dimensionné selon votre plan.

En plus de la limite de requêtes, il existe un quota quotidien d'écriture sur les requêtes qui modifient les canaux (écritures de produits, mises à jour d'inventaire, publication/retrait), car chaque écriture consomme aussi les quotas d'API de vos propres canaux. Votre utilisation actuelle est visible dans le tableau de bord sous Paramètres → Développeurs → Utilisation.

En-têtes

Chaque réponse vous indique où vous en êtes. Utilisez les en-têtes pour ralentir avant d'atteindre le 429 :

X-RateLimit-Limit: 40
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1784900412

Remaining indique combien de requêtes passent dès maintenant. Reset est la seconde (epoch Unix) à laquelle le seau est de nouveau entièrement plein (toutes les requêtes de Limit disponibles), et non le prochain créneau libre : juste après un 429, ce moment peut être à plusieurs secondes alors qu'une requête isolée passe déjà de nouveau. Pour savoir quand la prochaine requête passera, utilisez Retry-After sur le 429.

Quand vous recevez un 429

{ "error": { "type": "rate_limit_error", "code": "rate_limit_exceeded", "message": "…" } }

La réponse contient Retry-After (en secondes, exact, calculé à partir du seau et non estimé). Attendez ce délai, puis réessayez. Pour un débit soutenu, cadencez vos requêtes au rythme soutenu au lieu d'envoyer des rafales puis d'attendre.

write_quota_exceeded (également 429) signifie que le quota quotidien d'écriture est épuisé. Il est réinitialisé à minuit UTC ; les lectures continuent de fonctionner.

Les limites des canaux comptent plus que les nôtres

Chaque écriture de produit ou d'inventaire finit par appeler les API de vos canaux, qui ont leurs propres limites (souvent bien plus strictes). Les workers de Nembol les respectent automatiquement. Quand un canal limite le débit, l'opération indique channel_rate_limited et Nembol réessaie avec un délai croissant. Les endpoints batch (POST /inventory/batch) sont le moyen efficace de faire des mises à jour en masse : une seule requête API, des appels aux canaux cadencés au mieux.

Dernière mise à jour le 21 octobre 2026