Création d'applications Shopify : guide du développeur sur l'écosystème d'applications Shopify

Guide complet du développement d'applications Shopify : types d'applications, Shopify CLI, API Admin, API Storefront, webhooks, processus de révision et monétisation.

E

ECOSIRE Research and Development Team

Équipe ECOSIRE

19 février 202610 min de lecture2.1k Mots

Création d'applications Shopify : guide du développeur sur l'écosystème d'applications Shopify

Le Shopify App Store héberge plus de 10 000 applications et génère des milliards de revenus pour les développeurs. Que vous créiez une application personnalisée pour un seul commerçant ou une application publique pour des milliers de magasins, il est essentiel de comprendre l'architecture de l'application, les API et l'écosystème de Shopify. Ce guide couvre tout ce que les développeurs doivent savoir pour créer, lancer et faire évoluer les applications Shopify en 2026.

Q : Quels types d'applications Shopify pouvez-vous créer ?

Il existe trois types d'applications Shopify : les applications publiques répertoriées sur l'App Store de Shopify que tout commerçant peut installer, les applications personnalisées conçues pour une seule boutique spécifique et les applications en brouillon utilisées pendant le développement et les tests. Les applications publiques passent par le processus d'examen de Shopify, tandis que les applications personnalisées sont installées directement via l'administrateur du magasin.

Types d'applications expliqués

Applications publiques

Les applications publiques sont répertoriées sur le Shopify App Store et peuvent être installées par n'importe quel marchand Shopify. Ils utilisent OAuth pour l'authentification et doivent se conformer aux directives d'évaluation des applications de Shopify.

Caractéristiques :

  • Disponible dans plus de 4,8 millions de magasins Shopify
  • Revenus provenant d'abonnements, de frais d'utilisation ou d'achats uniques
  • Doit réussir le processus d'examen des applications de Shopify
  • Utilisez OAuth 2.0 pour l'authentification des commerçants
  • Soumis aux politiques et aux normes de qualité de l'App Store de Shopify

Applications personnalisées

Les applications personnalisées sont conçues pour un seul magasin et ne passent pas par le processus d'examen de l'App Store. Ils sont installés directement via le panneau d'administration du magasin.

Caractéristiques :

  • Conçu pour un marchand spécifique
  • Aucune liste App Store requise
  • Jetons d'accès générés dans l'administrateur Shopify
  • Aucun flux OAuth nécessaire
  • Idéal pour une logique métier et des intégrations sur mesure

Brouillons d'applications

Les brouillons d’applications sont utilisés pendant le développement. Elles fonctionnent comme des applications publiques mais ne peuvent être installées que sur les magasins de développement. Ils se convertissent en applications publiques après soumission à l'App Store.

Configuration de votre environnement de développement

CLI Shopify

Shopify CLI est l'outil de ligne de commande officiel pour le développement d'applications. Il échafaude des projets, gère les magasins de développement et gère le déploiement d'applications.

Pour commencer :

  1. Installez Node.js 18+ et npm
  2. Installez la CLI Shopify : npm install -g @shopify/cli @shopify/app
  3. Créez une nouvelle application : shopify app init
  4. Choisissez votre framework (Remix est le choix par défaut et recommandé)
  5. Commencer le développement : shopify app dev

La CLI configure automatiquement les tunnels ngrok pour le développement local, gère l'authentification des applications et permet le rechargement à chaud des modules.

Magasin de développement

Créez une boutique de développement gratuite via votre tableau de bord partenaire Shopify. Les magasins de développement ont un accès complet à toutes les fonctionnalités de Shopify et ne nécessitent pas de forfait payant. Vous pouvez créer un nombre illimité de magasins de développement pour les tests.

API Shopify

Shopify propose plusieurs API pour différents cas d'utilisation :

| API | Authentification | Cas d'utilisation | |-----|---------------|----------| | API d'administration (REST) ​​| OAuth / Jeton d'accès | Gestion de magasin, commandes, produits, clients | | API d'administration (GraphQL) | OAuth / Jeton d'accès | Identique à REST mais avec des requêtes flexibles | | API de vitrine | Jeton d’accès à la vitrine | Fonctionnalités orientées client, commerce sans tête | | API de paiement | Jeton d'accès à la caisse | Expériences de paiement personnalisées (Plus uniquement) | | API des applications de paiement | Identifiants du partenaire | Intégration de la passerelle de paiement | | API de fonctions | Modules Wasm | Remises personnalisées, expédition, logique de validation |

API d'administration

L'API Admin est l'interface principale de gestion des données du magasin. Il donne accès aux produits, aux commandes, aux clients, aux stocks, à l'exécution et bien plus encore.

GraphQL contre REST :

Shopify recommande l'API GraphQL Admin pour les nouveaux développements. Les avantages comprennent :

  • Demandez exactement les champs dont vous avez besoin (pas de surextraction)
  • Récupérer les ressources associées en une seule requête
  • Schéma fortement typé avec introspection
  • Meilleure utilisation des limites de débit (basée sur les coûts plutôt que sur les demandes)

Exemple GraphQL -- Récupération de produits :

query {
  products(first: 10) {
    edges {
      node {
        id
        title
        variants(first: 5) {
          edges {
            node {
              price
              inventoryQuantity
            }
          }
        }
      }
    }
  }
}

Limites de taux :

  • API GraphQL Admin : 1 000 points de coût par seconde (chaque champ a un coût)
  • API REST Admin : 40 requêtes par seconde (Basic/Shopify), 80 (Advanced/Plus)
  • API Storefront : 100 points de coût par seconde

API de vitrine

L'API Storefront est conçue pour les expériences orientées client. Il fournit un accès non authentifié aux produits, aux collections et aux fonctionnalités du panier. Utilisez-le lors de la construction :

  • Vitrines personnalisées (commerce sans tête)
  • Applications mobiles
  • Acheter des boutons intégrés sur des sites Web externes
  • Widgets de recommandation de produits

Webhooks

Les webhooks avertissent votre application lorsque des événements se produisent dans la boutique d'un commerçant. Au lieu d'interroger l'API, Shopify envoie des requêtes HTTP POST à ​​votre point de terminaison lorsque les données changent.

Webhooks essentiels pour la plupart des applications :

  • orders/create -- Nouvelle commande passée
  • orders/updated -- Statut de la commande modifié
  • products/update -- Données produit modifiées
  • products/delete -- Produit supprimé
  • app/uninstalled -- Le marchand a désinstallé votre application
  • shop/update -- Paramètres du magasin modifiés

Bonnes pratiques en matière de webhook :

  1. Répondez rapidement -- Renvoie un statut 200 dans les 5 secondes ; traiter les données de manière asynchrone
  2. Gérer les doublons -- Shopify peut envoyer le même webhook plusieurs fois ; mettre en œuvre l'idempotence
  3. Vérifier les signatures -- Validez l'en-tête X-Shopify-Hmac-SHA256 pour confirmer l'authenticité
  4. Mettre en œuvre une logique de nouvelle tentative -- Si votre point de terminaison échoue, Shopify réessaye jusqu'à 19 fois sur 48 heures.
  5. Utilisez des webhooks obligatoires -- Enregistrez app/uninstalled, customers/data_request, customers/redact et shop/redact pour plus de conformité.

Création d'une interface utilisateur d'application avec App Bridge et Polaris

Pont d'applications Shopify

App Bridge permet à l'interface utilisateur de votre application de s'afficher dans l'administrateur Shopify. Il fournit :

  • Intégration de la navigation avec la barre latérale d'administration de Shopify
  • Boîtes de dialogue modales, notifications toast et barres de chargement
  • Sélecteur de ressources pour sélectionner les produits, les collections et les clients
  • Barre de titre avec actions primaires et secondaires

Système de conception Polaris

Polaris est la bibliothèque de composants React de Shopify. Il fournit des composants d'interface utilisateur prédéfinis qui correspondent au langage de conception d'administration de Shopify :

  • Formulaires, boutons et champs de saisie
  • Tableaux de données et listes de ressources
  • Cartes, bannières et composants de mise en page
  • Sélecteurs de dates, filtres et pagination

L'utilisation de Polaris garantit que votre application semble native dans l'administrateur Shopify et réussit la révision de la conception.

Fonctions Shopify

Les fonctions Shopify vous permettent d'exécuter une logique métier personnalisée sur l'infrastructure de Shopify à l'aide de WebAssembly (Wasm). Ils remplacent les anciens scripts Script Editor et s'exécutent à des points clés du flux commercial :

  • Fonctions de remise - Logique de remise personnalisée (BOGO, tarification échelonnée, remises sur volume)
  • Fonctions d'expédition - Tarifs d'expédition personnalisés et options de livraison
  • Fonctions de paiement -- Masquer ou réorganiser les modes de paiement lors du paiement
  • Fonctions de validation -- Règles de validation de panier et de paiement personnalisées
  • Fonctions d'exécution -- Routage d'emplacement d'exécution personnalisé

Les fonctions s'exécutent en moins de 5 ms et s'exécutent sur les serveurs de Shopify, garantissant qu'elles fonctionnent quelle que soit la technologie de la vitrine (Liquide, Hydrogène ou tierce).

Le processus d'examen des applications

Les applications publiques doivent passer l'examen de Shopify avant d'être répertoriées sur l'App Store. La revue évalue :

Exigences techniques :

  • L'application doit utiliser les dernières versions des API Shopify
  • Implémentation OAuth appropriée avec des portées correctes
  • HTTPS pour tous les points de terminaison
  • Gestionnaires de webhooks obligatoires pour la conformité au RGPD
  • Gestion des erreurs et dégradation gracieuse

Exigences en matière d'expérience utilisateur :

  • Utiliser les composants Polaris pour l'interface utilisateur d'administration
  • Fournir des instructions claires d'intégration et de configuration
  • Inclure un lien d'aide/support dans l'application
  • Conception réactive pour toutes les tailles d'écran d'administrateur

Exigences commerciales :

  • Liste App Store claire et précise
  • Tarification et facturation transparentes
  • Politique de confidentialité et conditions d'utilisation
  • Canal d'assistance avec des temps de réponse raisonnables

Motifs de refus courants :

  1. Demander des étendues d'autorisation API inutiles
  2. Gestionnaires de webhooks RGPD manquants
  3. Mauvaise interface utilisateur qui ne suit pas les directives de Polaris
  4. Gestion des erreurs inadéquate
  5. Fonctionnalité cassée lors de l'examen

Le processus d'examen prend généralement 7 à 14 jours ouvrables. Répondez rapidement aux commentaires : Shopify fournit des conseils spécifiques sur les modifications requises.

## Stratégies de monétisation

Shopify prend en charge plusieurs modèles de facturation via l'API de facturation :

| Modèle | Idéal pour | Exemple | |-------|----------|---------| | Abonnement mensuel | Fonctionnalités principales de l'application | 9,99 $/mois pour basique, 29,99 $/mois pour pro | | Abonnement annuel | Clients engagés | 99 $/an (rabais sur le mois) | | Facturation basée sur l'utilisation | Consommation variable | 0,01 $ par appel API ou e-mail envoyé | | Frais uniques | Accès à vie | 49,99 $ d'achat unique | | Gratuité | Acquisition d'utilisateurs | Niveau gratuit avec mises à niveau payantes |

Conseils de tarification :

  • Shopify prend une part des revenus de 15 % sur le premier million de dollars de revenus, puis 0 % (selon les conditions actuelles de son programme de partenariat)
  • Offrez un essai gratuit (7 à 14 jours est la norme)
  • Créer une différenciation de valeur claire entre les niveaux de tarification
  • Envisagez une tarification basée sur l'utilisation pour les applications avec une consommation de ressources variable

Tests et assurance qualité

Avant de soumettre votre application pour examen :

  1. Tests unitaires – Tester la logique métier de base de manière isolée
  2. Tests d'intégration – Tester les interactions de l'API avec la boutique de développement de Shopify
  3. Tests d'interface utilisateur - Vérifiez que les composants Polaris s'affichent correctement
  4. Tests de webhook – Valider le traitement du webhook avec des charges utiles de test
  5. Tests de performances – Assurez-vous que les appels d'API restent dans les limites de débit sous charge
  6. Audit de sécurité – Vérifiez les vulnérabilités XSS, CSRF et d'injection
  7. Test de flux OAuth – Vérifier l'installation, l'authentification et la désinstallation

Utilisez le tableau de bord des partenaires de Shopify pour simuler différentes configurations de magasin et types de forfaits.

Développement d'applications professionnelles

Créer une application Shopify nécessite une expertise dans les modèles de plate-forme spécifiques à React, GraphQL, Node.js et Shopify. ECOSIRE fournit des services de développement d'applications Shopify professionnels aux entreprises qui ont besoin de fonctionnalités personnalisées au-delà de ce qu'offrent les applications existantes.

Que vous ayez besoin d'une application personnalisée pour votre propre boutique ou que vous souhaitiez créer une application publique pour l'écosystème Shopify, notre équipe de développement gère l'architecture, le développement, les tests et la soumission à l'App Store. Nous proposons également des solutions d'automatisation qui s'intègrent aux API et aux webhooks de Shopify.

Contactez notre équipe pour discuter de votre projet de développement d'application Shopify.

Points clés à retenir

  • Shopify propose trois types d'applications : publique (App Store), personnalisée (magasin unique) et brouillon (développement)
  • L'API GraphQL Admin est recommandée par rapport à REST pour les nouveaux développements
  • Les webhooks permettent le traitement des événements en temps réel sans interrogation
  • Les fonctions Shopify exécutent une logique métier personnalisée sur l'infrastructure de Shopify via WebAssembly
  • App Bridge et Polaris garantissent que votre application s'intègre parfaitement à l'administrateur Shopify
  • Le processus d'examen de l'application prend 7 à 14 jours et évalue la qualité technique, l'UX et les exigences commerciales.
  • Monétisez via des abonnements, une facturation basée sur l'utilisation ou des frais uniques via l'API de facturation
E

Rédigé par

ECOSIRE Research and Development Team

Création de produits numériques de niveau entreprise chez ECOSIRE. Partage d'analyses sur les intégrations Odoo, l'automatisation e-commerce et les solutions d'entreprise propulsées par l'IA.

Discutez sur WhatsApp