L’API GraphQL Shopify est l’interface de programmation recommandée par Shopify pour développer des intégrations et des applications connectées à une boutique. Contrairement à l’API REST qui impose un endpoint par type de ressource, GraphQL permet d’interroger précisément les données nécessaires en une seule requête, ce qui réduit le nombre d’appels et améliore la performance des intégrations.
À retenir
- Shopify oriente désormais tous les nouveaux développements vers l’API GraphQL plutôt que REST
- GraphQL permet de récupérer plusieurs types de données en une seule requête, contre plusieurs appels en REST
- L’API GraphQL Shopify est versionnée par trimestre, avec une rétrocompatibilité limitée dans le temps
- Le coût d’une requête GraphQL est calculé en points, avec un quota à respecter pour éviter le rate limiting
- GraphQL est indispensable pour exploiter certaines fonctionnalités Shopify récentes uniquement disponibles via cette API
Pourquoi Shopify privilégie GraphQL
Shopify a fait de GraphQL le standard de référence pour son écosystème de développement. Plusieurs raisons expliquent ce choix stratégique.
L’efficacité des requêtes est le principal avantage. Avec REST, récupérer une commande et les informations du client associé nécessite généralement deux appels distincts. Avec GraphQL, une seule requête peut combiner les deux, en spécifiant exactement les champs souhaités, sans données superflues.
L’évolution des fonctionnalités se concentre désormais sur GraphQL. Plusieurs nouveautés Shopify, notamment autour du checkout et des extensions d’interface, ne sont accessibles que via cette API. Une intégration construite uniquement sur REST se retrouve donc limitée face aux évolutions récentes de la plateforme.
La structure typée de GraphQL facilite la détection d’erreurs dès le développement, puisque le schéma définit précisément les types de données attendus et disponibles.
Comment fonctionne une requête GraphQL Shopify
Une requête GraphQL envoie un payload structuré décrivant exactement les champs souhaités, plutôt que d’appeler un endpoint fixe. Le serveur Shopify renvoie une réponse qui respecte exactement cette structure, sans champ supplémentaire non demandé.
Cette approche change la façon de concevoir une intégration : au lieu de multiplier les appels pour assembler les données nécessaires côté client, le développeur compose une requête unique qui reflète précisément le besoin métier. Pour une intégration ERP qui doit récupérer une commande avec ses lignes de produits, son client et son adresse de livraison, une seule requête GraphQL bien construite remplace plusieurs appels REST.
Le système de coût des requêtes GraphQL
Shopify limite l’usage de son API GraphQL via un système de points plutôt qu’un simple nombre de requêtes par seconde. Chaque champ demandé dans une requête a un coût en points, et chaque boutique dispose d’un quota de points disponibles qui se renouvelle progressivement.
Une requête qui demande beaucoup de champs imbriqués (par exemple, une liste de commandes avec tous les détails de chaque ligne de produit) coûte plus de points qu’une requête simple. Concevoir des requêtes efficaces, qui ne demandent que les champs réellement utiles, est donc essentiel pour éviter d’atteindre les limites de débit, particulièrement sur les intégrations à fort volume comme une synchronisation ERP en temps réel.
Le versionnement de l’API GraphQL Shopify
Shopify publie une nouvelle version de son API GraphQL chaque trimestre. Chaque version reste supportée pendant une durée limitée avant d’être dépréciée, ce qui implique une maintenance régulière des intégrations existantes.
Pour un projet d’intégration durable, notamment dans un contexte B2B où la stabilité de la synchronisation ERP est critique, il est recommandé de suivre les notes de version Shopify et de prévoir une mise à jour planifiée des appels GraphQL concernés, plutôt que de subir une dépréciation en urgence.
GraphQL pour les intégrations B2B et applications sur-mesure
L’API GraphQL est particulièrement adaptée aux projets d’intégration complexes qui manipulent plusieurs types de ressources simultanément, ce qui correspond exactement aux besoins des marchands B2B connectant Shopify à un ERP comme Sage, Cegid ou Odoo.
Pour une application Shopify sur-mesure, GraphQL permet de construire des fonctionnalités avancées difficilement réalisables avec REST, notamment autour des prix par catalogue client, des conditions tarifaires B2B ou de la gestion fine des stocks par emplacement, utile pour les déploiements Shopify POS multi-sites.
Pour les cas d’usage en temps réel, GraphQL se combine naturellement avec les webhooks Shopify : le webhook notifie l’événement, et une requête GraphQL ciblée récupère ensuite les données complémentaires nécessaires au traitement.
Faire développer une intégration GraphQL fiable
Construire une intégration GraphQL performante demande de bien maîtriser la gestion du coût des requêtes, le versionnement de l’API, et la structuration des requêtes pour éviter la sur-récupération de données. Ces choix techniques ont un impact direct sur la fiabilité et la scalabilité d’une intégration à enjeu métier.
Gradiweb développe des intégrations Shopify sur l’API GraphQL pour connecter les boutiques de ses clients à leurs systèmes de gestion, qu’il s’agisse d’un ERP, d’un CRM ou d’un outil logistique. Pour les projets impliquant votre système d’information dans son ensemble, consultez notre page intégration SI e-commerce.
« Notre ancienne intégration en REST devenait difficile à maintenir avec la croissance de notre catalogue B2B. Gradiweb a repris l’intégration sur l’API GraphQL, ce qui a nettement réduit les temps de synchronisation avec notre ERP et simplifié la gestion des tarifs par client. » Responsable digital, distributeur B2B multi-catalogue
Et si on en discutait ?
Votre projet mérite une expertise sur-mesure,échangeons quelques minutes et repartez avec un devis personnalisé.
Demander un devisFAQ : GraphQL API Shopify
Faut-il migrer ses anciennes intégrations REST vers GraphQL ?
Ce n’est pas obligatoire dans l’immédiat pour les fonctionnalités déjà couvertes par REST, mais c’est recommandé pour tout nouveau développement et indispensable pour accéder aux fonctionnalités Shopify les plus récentes, qui ne sont disponibles qu’en GraphQL.
Qu’est-ce que le coût en points d’une requête GraphQL ?
Chaque champ demandé dans une requête GraphQL Shopify a un coût exprimé en points. La boutique dispose d’un quota de points qui se renouvelle progressivement, et dépasser ce quota entraîne un rate limiting temporaire des requêtes suivantes.
Combien de temps une version de l’API GraphQL Shopify reste-t-elle supportée ?
Shopify publie une nouvelle version chaque trimestre et maintient généralement le support des versions précédentes pendant environ un an, avant leur dépréciation définitive.
GraphQL est-il plus difficile à apprendre que REST pour un développeur ?
GraphQL demande une courbe d’apprentissage initiale différente de REST, notamment sur la structuration des requêtes et la compréhension du schéma. Pour un développeur expérimenté, cette montée en compétence reste rapide, et les gains de performance compensent largement l’effort initial.
Peut-on utiliser à la fois REST et GraphQL dans le même projet ?
Techniquement oui, mais ce n’est pas recommandé pour de nouveaux développements. Shopify concentre ses efforts sur GraphQL, et mélanger les deux approches complexifie la maintenance à long terme d’une intégration.
GraphQL est-il nécessaire pour une intégration ERP simple ?
Pour une synchronisation basique (commandes et stocks), REST peut encore suffire à court terme. Mais dès que le besoin s’étend (tarifs par client, gestion multi-emplacements, automatisations avancées), GraphQL devient nettement plus adapté et pérenne.
