La Shopify Partner API : accès, autorisations et données
L'API Partner est l'interface qui te permet de lire les installations, les désinstallations, les facturations et les gains de tes applications en dehors du tableau de bord Partner. C'est aussi à elle que se connectent tous les outils d'analyse pour applications Shopify. Voici comment fonctionne l'accès, d'après la documentation de référence de Shopify.
Par Arthur Renard, mis à jour le
Créer un client d'API
Un client d'API est un accès que tu ouvres toi-même pour un logiciel. Pour en créer un :
- Depuis le 27 octobre 2026, les clients de l'API Partner sont dans le Dev Dashboard de Shopify : choisis ton organisation, ouvre « Organization settings » (les réglages de l'organisation), puis « Users », puis « Security ». Le lien « Settings » du tableau de bord Partner mène maintenant à la même page. Si tu ne la trouves pas, Shopify conseille de demander au propriétaire de ton organisation de vérifier tes accès.
- Crée un client, donne-lui un nom et coche les autorisations dont il a besoin (voir plus bas).
- Copie le jeton d'accès, la clé secrète qui ouvre l'API. Garde-le pour toi : il donne accès à toutes les applications de l'organisation que couvrent les autorisations cochées.
Un client ne voit que l'organisation où il a été créé : il faut un client par organisation. Pour changer de jeton sans interrompre tes outils, génère un jeton secondaire depuis la même page et passe dessus.
Quelle autorisation donne accès à quoi
| Autorisation | Ce qu'elle ouvre |
|---|---|
| « View financials » (voir les finances) | Les transactions qui comptent dans tes gains de partenaire. Elle ouvre aussi deux écritures : résilier l'abonnement Shopify App Pricing d'un marchand et accorder un crédit à une boutique. |
| « Manage apps » (gérer les applications) | Tes applications et leurs événements : installations, désinstallations, facturations, pour les applications publiques et privées de l'organisation. Aussi l'historique des événements de l'organisation, gains compris, avec la commission de Shopify. |
| « Manage themes » (gérer les thèmes) | Les thèmes Shopify que gère ton organisation. |
| « Manage jobs » (gérer les missions) | Les conversations et les missions de l'Experts Marketplace, la place de marché où les marchands engagent des experts Shopify. |
Ne coche que ce dont un outil a besoin. Un outil d'analyse pour applications peut se contenter de « Manage apps », puisque l'historique des événements porte chaque gain. « View financials » ajoute la durée de facturation de chaque vente (mensuelle ou annuelle), en plus des deux écritures ci-dessus.
Appeler l'API
L'API Partner est une API GraphQL, un langage de requêtes où tu demandes exactement les données que tu veux. Tu envoies des requêtes POST à https://partners.shopify.com/{organization_id}/api/{version}/graphql.json, avec le jeton dans l'en-tête X-Shopify-Access-Token. L'identifiant de l'organisation est le nombre qui figure dans l'adresse de ton tableau de bord Partner, et la version (comme 2026-10) garde ton intégration stable quand l'API évolue.
La limite est de quatre requêtes par seconde et par client. Au-delà, l'API répond par une erreur 429, « Too many requests » (trop de requêtes).
Ce que tu peux lire
- Les événements de tes applications : installations, désinstallations, fermetures et réouvertures de boutique, abonnements acceptés, activés, résiliés, gelés (suspendus pour défaut de paiement) ou dégelés, facturations à l'usage et ponctuelles, crédits accordés aux marchands. Une désinstallation porte la raison choisie par le marchand et le texte qu'il a ajouté.
- Les transactions qui comptent dans tes gains. Shopify précise qu'elles servent à l'analyse, pas à la comptabilité ni aux rapports financiers.
- Pour Shopify App Pricing : l'abonnement en cours d'une boutique, la résiliation d'un abonnement, et l'historique des événements (installations, désinstallations, facturations, gains, changements d'abonnement, crédits).
Voir comment calculer le revenu mensuel récurrent (MRR) et comment mesurer le taux de départ (churn) pour savoir quoi faire de ces événements.
Pourquoi le Dev Dashboard, le Partner Dashboard et l'API peuvent donner des chiffres différents pour la même application : Dev Dashboard ou Partner Dashboard.
Sans écrire de code
Luseri se connecte à ton compte Partner avec un client qui n'a besoin que de l'autorisation « Manage apps », le lit sans rien y changer, et transforme les événements en MRR, en rétention par cohorte (la part des boutiques qui restent, par groupe installé à la même période) et en raisons de désinstallation. Le jeton est rangé chiffré, et retirer ton application de Luseri efface ses données.
Questions
- Où créer un client de la Shopify Partner API ?
- Depuis le 27 octobre 2026, dans le Dev Dashboard : choisis ton organisation, puis « Organization settings », « Users », « Security ». Le lien « Settings » du tableau de bord Partner y mène aussi.
- Quelle est la limite de requêtes de l'API Partner ?
- Quatre requêtes par seconde et par client d'API. Au-delà, les requêtes sont limitées avec une erreur 429.
- Où trouver l'identifiant de mon organisation ?
- L'API Partner demande ton Partner ID : le nombre qui figure dans l'adresse de ton tableau de bord Partner, juste après partners.shopify.com/. Shopify prévient que le nombre dans l'adresse du Dev Dashboard est un autre identifiant d'organisation, qui ne marche pas ici.
- Je peux utiliser les transactions de l'API Partner pour ma comptabilité ?
- Shopify précise qu'elles servent à l'analyse, pas à la comptabilité ni aux rapports financiers.