Aller au contenu principal
Version: 1.x

Comprendre l'API REST de WooCommerce

L'API REST de WooCommerce est comme un ensemble de « canaux » standardisés qui permettent aux propriétaires de magasins de connecter leur magasin WooCommerce à d'autres applications et services.

Voici une explication simple de son fonctionnement :

  1. Elle agit comme un pont entre votre magasin WooCommerce et des applications externes, leur permettant de communiquer et de partager des données.

  2. L'API fonctionne en envoyant des requêtes à des points de terminaison spécifiques - considérez-les comme des « canaux » pour différents types de données de magasin. Par exemple, il existe des points de terminaison pour les produits, les commandes et les clients.

  3. Les applications externes peuvent utiliser ces points de terminaison pour :

  • Obtenir des informations (comme récupérer une liste de produits)
  • Ajouter de nouvelles données (comme créer une nouvelle commande)
  • Mettre à jour les informations existantes (comme modifier le prix d'un produit)
  • Supprimer des données (comme supprimer un produit obsolète)

Au lieu de s'appuyer sur des hooks et des filtres PHP (comme le font de nombreux plugins WordPress traditionnels), il fonctionne en envoyant et en recevant des données dans un format structuré et prévisible, appelé JSON.

wc-rest-api

Affichage des données JSON dans le POS

Pour vous aider à comprendre ce que le POS « voit », nous avons inclus une vue JSON dans de nombreuses parties de l'interface. Par exemple, lorsque vous modifiez les métadonnées de commande ou une ligne de panier dans le POS, vous verrez un onglet JSON (comme dans la capture d'écran ci-dessous).

Modification d'un élément de ligne dans le POS

Affichage des données JSON pour un article en ligne dans le POS

Le navigateur comprend également un Network Inspector, un outil qui vous permet de surveiller les données envoyées et reçues entre votre navigateur et le serveur, y compris les données JSON.

Inspecteur réseau dans le navigateur

Inspecteur réseau dans le navigateur

Pourquoi certains plugins ne fonctionnent-ils pas dans le POS ?

WooCommerce POS télécharge les données produit, commande et client de votre boutique WooCommerce via l'API REST. Il conserve ensuite une copie locale de ces données afin de pouvoir continuer à fonctionner même si votre connexion Internet est instable. Cette approche rend le PDV plus rapide et plus fiable dans un environnement de paiement très fréquenté.

Cependant, cela signifie que notre PDV ne « voit » pas les modifications qui se produisent de manière dynamique sur votre site en temps réel. Par exemple :

Type de plug-inPourquoi cela ne fonctionne pas
Tarification dynamiqueSi un autre plug-in de votre boutique calcule un prix unique pour chaque client connecté, le PDV n'obtiendra pas automatiquement ce prix personnalisé.
Modules complémentaires de produitSi un autre plug-in de votre boutique ajoute des données de produit supplémentaires, le PDV n'obtiendra pas automatiquement ces données. Le POS n'obtient que les données exposées via l'API REST.

Étapes suivantes

Pour une analyse technique plus approfondie, consultez la documentation officielle de l'API REST de WooCommerce : https://woocommerce.github.io/woocommerce-rest-api-docs/