Aller au contenu
Cercle IA Tech · Intégration Un site du réseau Cercle IA Tech

Guide

API Shopify : limites d'appels et webhooks

Brancher un assistant IA sur Shopify : seau à fuite, limites REST et GraphQL par offre, erreur 429, Retry-After, webhooks, doublons, rattrapage.

Mis à jour le

Un assistant IA branché sur une boutique Shopify répond sur les commandes, les stocks ou les clients. Pour cela il appelle l'API de la boutique, et c'est là que les limites interviennent. Ce que dit la documentation officielle de Shopify, lue le 16/11/2026, tient en trois idées : un seau qui se vide, des limites qui dépendent de l'offre, et des webhooks qu'il faut doubler d'un rattrapage.

Pour relier la boutique à un assistant, examinez la documentation API d’ALMA. Définissez les données de commande nécessaires et la procédure de rattrapage dans votre connecteur, indépendamment de la formulation des réponses.

Le principe : un seau qui se remplit

Shopify applique la plupart de ses limites par un algorithme de seau à fuite : chaque application, pour chaque boutique, a un seau dont la taille et la vitesse de vidage dépendent de l'API et de l'offre de la boutique. Chaque requête remplit le seau. S'il est plein, vous recevez une erreur de limitation et devez attendre. Délai de reprise recommandé : une seconde.

L'API REST Admin

La documentation précise que l'API REST Admin est une API « legacy » depuis le 01/10/2024 et renvoie vers GraphQL pour les nouveaux développements. Ses limites :

Offre Requêtes par seconde
Standard 2 (seau de 40 par application et par boutique)
Advanced Shopify 4
Shopify Plus 20 (seau de 400)
Entreprise (Commerce Components) 40

Au dépassement : réponse 429 Too Many Requests, avec un en-tête Retry-After qui donne le nombre de secondes à attendre. L'en-tête X-Shopify-Shop-Api-Call-Limit indique votre consommation ; 32/40 signifie 32 requêtes comptées sur un seau de 40.

L'API GraphQL Admin

Ici, la limite se compte en points de coût de requête, par seconde :

Offre Points par seconde
Standard 100
Advanced Shopify 200
Shopify Plus 1 000
Entreprise 2 000

Une seule requête ne peut pas dépasser 1 000 points, quelle que soit l'offre. La réponse contient, sous extensions, requestedQueryCost, actualQueryCost et throttleStatus (avec maximumAvailable, currentlyAvailable et restoreRate) : un assistant peut s'en servir pour s'auto-limiter avant d'être refusé. La page décrit aussi un plafond quotidien : un 429 pour les créations et mises à jour de produits (productCreate, productUpdate, productVariantsBulkCreate) quand une boutique dépasse 500 000 variantes.

Les webhooks

Shopify peut livrer un événement à une adresse, à une URI Google Pub/Sub ou à un ARN Amazon EventBridge. Trois consignes de la documentation :

  1. Vérifier la signature HMAC, portée par l'en-tête X-Shopify-Hmac-Sha256.
  2. Ignorer les doublons grâce à X-Shopify-Webhook-Id.
  3. Ne pas compter sur une livraison garantie : la page dit que la livraison « n'est pas toujours garantie » et recommande des tâches de rattrapage qui reprennent périodiquement les données, par exemple avec un filtre updated_at depuis le dernier passage.

La page lue ne dit rien du délai de réponse exigé ni des réessais de Shopify : ne les inventez pas, vérifiez-les avant de dimensionner votre serveur. Le montage de réception est décrit dans webhook et IA.

Tester le rattrapage

Dans un essai contrôlé, faites manquer un événement au connecteur, puis lancez sa tâche de rattrapage. Vérifiez que la commande réapparaît dans l’état attendu sans être comptée deux fois. Rejouez aussi un événement déjà reçu pour distinguer la détection d’un doublon de la correction d’une donnée devenue ancienne.

Ce que cela change pour l'assistant

Un assistant qui répond « combien de commandes aujourd'hui ? » n'a pas besoin d'interroger la boutique à chaque message. Mettre en cache le résultat quelques minutes, lire par GraphQL en demandant seulement les champs utiles, et passer par une file d'attente (voir Cloudflare Queues et les réessais) respecte le seau. Ces choix sont des conséquences de la documentation, non des règles de Shopify.

Pour la suite, la liste des échéances à surveiller est dans la page mise en production. La version côté site, avec un assistant dans la vitrine, est sur Alaisia · Studios web.

Questions fréquentes

Quelle est la limite de l'API REST Admin de Shopify ?

2 requêtes par seconde sur l'offre Standard, 4 sur Advanced Shopify, 20 sur Shopify Plus, 40 sur l'offre entreprise. L'API REST Admin est qualifiée de « legacy » depuis le 01/10/2024.

Comment savoir où on en est du quota ?

L'en-tête X-Shopify-Shop-Api-Call-Limit : 32/40 veut dire 32 requêtes comptées pour un seau de 40.

Comment éviter de traiter deux fois un même webhook ?

En ignorant les livraisons en double grâce à l'en-tête X-Shopify-Webhook-Id.

Sources

Pages consultées pour écrire cet article :

  1. https://alma.iarche.fr/fr/api-docs
  2. https://shopify.dev/docs/api/usage/limits
  3. https://shopify.dev/docs/api/admin-rest/usage/rate-limits
  4. https://shopify.dev/docs/apps/build/apis/graphql-admin/rate-limits
  5. https://shopify.dev/docs/apps/build/webhooks

À lire aussi