L'API Shopify est l'interface qui permet à des outils externes (ERP, CRM, logistique, applications, IA) de lire et de modifier les données de votre boutique : produits, commandes, clients, stocks. Dans ce guide, nous passons en revue les différentes API Shopify, la façon d'obtenir une clé, des cas d'usage réels d'intégration, ainsi que les limites et quotas à respecter pour ne rien casser. Chez Stellar, nous livrons des intégrations API toutes les semaines sur les 100+ boutiques que nous avons accompagnées : ce guide condense ce que nous en retenons sur le terrain.
Sommaire
Qu'est-ce que l'API Shopify ?
Une API (Application Programming Interface) est une porte d'entrée sécurisée qui permet à un logiciel de dialoguer avec un autre. L'API Shopify permet donc à n'importe quel outil externe, votre ERP, votre CRM, votre logisticien ou un script maison, de consulter et de modifier les données de votre boutique sans passer par l'interface d'administration.
Imaginez votre boutique au centre d'un écosystème : à gauche, l'ERP qui pousse les prix et les stocks. À droite, le CRM qui récupère les nouveaux clients. En dessous, le logisticien qui reçoit les commandes à expédier et renvoie les numéros de suivi. Chacune de ces flèches est un appel API. C'est ce qui fait de Shopify une plateforme ouverte, et non une boîte fermée.
En pratique, trois approches coexistent pour se connecter à une boutique :
- L'app publique, installée depuis le Shopify App Store, qui utilise l'API pour vous sans que vous ayez à écrire une ligne de code.
- L'app custom, créée directement dans l'admin de votre boutique, qui génère un jeton d'accès pour connecter un outil précis à votre boutique uniquement.
- L'intégration sur-mesure, un développement dédié qui orchestre plusieurs API pour répondre à un besoin métier spécifique.
Les différentes API Shopify
Parler de « l'API Shopify » au singulier est un abus de langage : Shopify expose plusieurs API, chacune avec son rôle. Voici les cinq à connaître pour comprendre 95 % des projets d'intégration.
| API | À quoi elle sert | Qui l'utilise | Exemple concret |
|---|---|---|---|
| Admin API | Gérer la boutique : produits, commandes, clients, stocks, promotions | ERP, CRM, outils back-office, apps | Un ERP met à jour les stocks chaque nuit |
| Storefront API | Afficher la boutique sur une vitrine personnalisée (voir notre page Storefront API et Hydrogen) | Développeurs front-end | Un site sur-mesure affiche le catalogue en temps réel |
| Orders API (partie de l'Admin API) | Lire, créer et modifier les commandes | Logisticiens, outils de facturation | Le WMS récupère les commandes à préparer toutes les 5 minutes |
| Products API (partie de l'Admin API) | Créer et mettre à jour les fiches produits et variantes | PIM, ERP, outils d'import | Un PIM synchronise 3 000 références avec leurs images |
| Ajax / Cart API | Manipuler le panier côté navigateur, dans le thème | Développeurs de thèmes | Ajouter un produit au panier sans recharger la page |
Retenez la distinction fondamentale : l'Admin API gère la boutique, la Storefront API l'affiche. La première est celle que vous utiliserez dans la quasi-totalité des projets de connexion à des outils métier.
Comment obtenir sa clé API Shopify
La clé API Shopify (plus précisément le jeton d'accès d'une app custom) s'obtient en quelques minutes, sans coder, directement depuis l'admin de votre boutique. Voici le pas à pas exact :
- Ouvrez Paramètres en bas à gauche de votre admin Shopify.
- Cliquez sur Apps et canaux de vente.
- Cliquez sur Développer des apps (si c'est la première fois, Shopify vous demande d'autoriser le développement d'apps custom).
- Cliquez sur Créer une app, donnez-lui un nom explicite, par exemple « Connexion ERP ».
- Dans l'onglet Configuration, définissez les autorisations (scopes) : lecture des produits, écriture des commandes, etc.
- Installez l'app sur la boutique, puis récupérez le jeton d'accès Admin API dans l'onglet Identifiants API.
Encadré sécurité, à lire deux fois. Ce jeton donne accès à vos données selon les scopes accordés : ne le partagez jamais par email ou dans un document partagé, et ne l'affichez jamais côté navigateur. Appliquez le principe du moindre privilège : si votre outil doit seulement lire les commandes, n'accordez que le scope de lecture des commandes, rien d'autre. Shopify n'affiche le jeton qu'une seule fois : stockez-le dans un gestionnaire de secrets, et révoquez-le immédiatement en cas de doute.
Les webhooks : être prévenu en temps réel
Un webhook est l'inverse d'un appel API : au lieu d'interroger Shopify régulièrement pour savoir si quelque chose a changé, c'est Shopify qui notifie votre outil dès qu'un événement se produit. Résultat : pas de délai, pas d'appels inutiles, pas de quota consommé pour rien.
Quatre exemples concrets que nous mettons régulièrement en place :
- Commande créée vers Slack : chaque nouvelle commande apparaît instantanément dans un canal de l'équipe, avec le montant et les produits.
- Stock bas vers email : dès qu'une variante passe sous un seuil, l'acheteur reçoit une alerte de réassort.
- Client créé vers CRM : chaque nouveau compte client est poussé dans le CRM avec ses informations de contact et son consentement marketing.
- Remboursement vers compta : chaque avoir est transmis à l'outil comptable, qui génère l'écriture correspondante sans ressaisie.
Les webhooks se configurent soit via une app (Shopify Flow permet d'en couvrir une partie sans code), soit via l'API elle-même pour les cas avancés. Un point de vigilance : votre serveur doit répondre rapidement à chaque notification, sinon Shopify finit par désactiver le webhook après plusieurs échecs successifs. Prévoyez toujours un mécanisme de reprise.
5 cas d'usage réels d'intégration API
Voici cinq familles d'intégrations que nous livrons réellement chez Stellar. Nous les présentons sans les chiffres de nos clients, mais avec la logique exacte de chaque projet : le problème de départ, l'API mobilisée et ce que cela change au quotidien.
1. Synchronisation ERP
Le problème : des stocks et des prix maintenus à la main dans deux systèmes, avec des écarts qui finissent en survente. La solution : un connecteur qui fait de l'ERP la source de vérité et pousse prix, stocks et références vers l'Admin API à intervalle régulier. Si vous n'êtes pas encore équipé, commencez par choisir l'ERP à connecter avant de penser au connecteur : le sens des flux dépend entièrement de l'outil retenu.
2. Flux logistique
Le problème : des commandes exportées en CSV et réimportées chez le logisticien, avec les erreurs et les retards que cela implique. La solution : les commandes partent automatiquement vers le WMS via l'Orders API, et les numéros de suivi remontent dans Shopify dès l'expédition, ce qui déclenche l'email de suivi au client sans intervention humaine.
3. Dashboard sur-mesure
Le problème : un dirigeant qui pilote plusieurs canaux et perd du temps à consolider ses chiffres. La solution : un tableau de bord qui agrège les données de vente via l'Admin API (en GraphQL) et les croise avec les dépenses publicitaires, pour une lecture unique de la marge par produit et par canal.
4. Outil IA connecté au catalogue
Le problème : des fiches produits longues à rédiger et hétérogènes. La solution : un outil développé par notre Studio qui lit le catalogue via l'API, génère des contenus structurés, puis écrit les résultats dans la boutique, y compris pour lire et écrire des metafields qui enrichissent chaque fiche.
5. Reporting et connexions CRM
Le problème : des équipes commerciales qui ne voient pas ce que leurs clients professionnels commandent en ligne. La solution : les commandes et les comptes clients sont poussés vers le CRM en continu, ce qui est particulièrement structurant pour les intégrations CRM pour le B2B, où le suivi de compte conditionne le réachat.
« La question qui compte n'est pas "quelle API appeler", c'est "qui sera responsable de ce flux dans six mois". Une intégration sans propriétaire clair devient une dette. C'est le premier point que nous verrouillons sur chaque projet, avant d'écrire le moindre appel. »
Florian Pohl, co-fondateur de Stellar Projects
Pour donner un ordre d'idée de ce qu'est un appel API, voici une requête GraphQL Admin réelle et volontairement simple, qui récupère les cinq derniers produits créés :
# Récupère les 5 produits les plus récents avec leur stock total
query ProduitsRecents {
products(first: 5, sortKey: CREATED_AT, reverse: true) {
edges {
node {
id # identifiant global du produit
title # nom de la fiche produit
totalInventory # stock cumulé de toutes les variantes
}
}
}
}Limites, quotas et pièges
L'API Shopify est limitée en débit, et c'est la première cause d'échec des intégrations mal conçues. Deux mécanismes coexistent :
- Sur l'API REST : un système de « seau percé » (leaky bucket). Vous disposez d'une réserve d'appels qui se vide à chaque requête et se recharge en continu, environ 2 requêtes par seconde en plan standard. Au-delà, Shopify répond par une erreur 429 et il faut patienter.
- Sur l'API GraphQL : un budget de points de coût. Chaque requête coûte un nombre de points proportionnel à ce qu'elle demande, et le budget se recharge chaque seconde. Une requête bien construite récupère en un appel ce que REST demanderait en dix.
Point important pour tout projet lancé en 2026 : Shopify a officiellement placé son API REST Admin en maintenance au profit de GraphQL. Les nouvelles apps publiques doivent utiliser GraphQL, et les nouvelles fonctionnalités ne sortent plus qu'en GraphQL. Si vous lancez une intégration aujourd'hui, elle doit être pensée GraphQL d'abord : un connecteur écrit en REST est un connecteur qui devra être réécrit.
Les erreurs que nous voyons le plus souvent en audit : des scripts qui interrogent l'API en boucle là où un webhook suffirait, des jetons d'accès avec tous les scopes accordés « pour être tranquille », des intégrations sans gestion des erreurs 429 qui perdent des données en silence, et des apps custom dont plus personne ne sait ce qu'elles font. Chacune de ces erreurs se corrige, mais toutes coûtent moins cher à éviter dès la conception.
Faut-il coder ou passer par une app ?
Notre position est simple et parfois contre-intuitive pour une agence qui vit du développement : le sur-mesure est le dernier recours, pas le premier réflexe. L'ordre de décision que nous appliquons à chaque projet :
- Une app publique existe et couvre le besoin ? Prenez-la. Elle est maintenue, mise à jour à chaque évolution de l'API, et son coût mensuel est presque toujours inférieur au coût de possession d'un développement.
- Le besoin est simple mais spécifique ? Une app custom avec quelques scopes bien choisis, éventuellement combinée à Shopify Flow, couvre énormément de cas sans projet de développement lourd.
- Le besoin est structurant et différenciant ? Là, le sur-mesure se justifie : c'est le cas des connecteurs ERP complexes, des dashboards de pilotage et des outils IA connectés à votre boutique que nous construisons au Studio.
Le bon critère n'est pas technique, il est économique : un développement sur-mesure se justifie quand le flux qu'il automatise est au cœur de votre marge ou de votre différenciation. Pour aller plus loin sur l'écosystème dans son ensemble, notre guide complet Shopify replace les API dans la vue d'ensemble d'un projet e-commerce. Et si vous hésitez encore sur votre propre cas, une conversation de trente minutes avec notre équipe suffit généralement à trancher.