Luseri

Luseri / Guides

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.

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 :

  1. Dans le tableau de bord Partner, ouvre « Settings » (les réglages), puis « Partner API clients » (les clients de l'API Partner), puis « Manage Partner API clients » (gérer ces clients). Seul le propriétaire de l'organisation, c'est-à-dire du compte Partner, peut le faire.
  2. Crée un client, donne-lui un nom et coche les autorisations dont il a besoin (voir plus bas).
  3. 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

AutorisationCe qu'elle ouvre
« View financials » (voir les finances)Les transactions qui comptent dans tes gains de partenaire. Elle sert aussi à résilier des abonnements Shopify App Pricing.
« 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.
« 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 a besoin de « View financials » et de « Manage apps », pas des deux autres.

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.

Sans écrire de code

Luseri se connecte à ton compte Partner avec un client qui a les autorisations « View financials » et « 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

Qui peut créer un client de la Shopify Partner API ?
Seul le propriétaire de l'organisation Partner, depuis « Settings », puis « Partner API clients ».
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 ?
C'est le nombre qui figure dans l'adresse de ton tableau de bord Partner, juste après partners.shopify.com/.
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.

Sources