Passer 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 permet aux propriétaires de boutiques de connecter leur boutique WooCommerce à d'autres applications et services.

Voici une explication simple de son fonctionnement :

  1. Elle agit comme un pont entre votre boutique WooCommerce et des applications externes, permettant à celles-ci de communiquer et de partager des données.

  2. L'API fonctionne en envoyant des requêtes à des endpoints spécifiques - pensez-y comme à des "canaux" pour différents types de données de la boutique. Par exemple, il existe des endpoints pour les produits, les commandes et les clients.

  3. Les applications externes peuvent utiliser ces endpoints pour :

  • Récupérer des informations (comme obtenir une liste de produits)
  • Ajouter de nouvelles données (comme créer une nouvelle commande)
  • Mettre à jour des informations existantes (comme changer 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), elle fonctionne en envoyant et en recevant des données dans un format structuré et prévisible, connu sous le nom de JSON.

wc-rest-api

Visualisation 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 la commande ou un article de ligne dans le POS, vous verrez un onglet JSON (comme dans la capture d'écran ci-dessous).

Modification d'un article de ligne dans le POS

Visualisation des données JSON pour un article de ligne dans le POS

Le navigateur inclut également un inspecteur de réseau, 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 de réseau dans le navigateur

Inspecteur de réseau dans le navigateur

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

WCPOS télécharge les données de produit, de commande et de client depuis votre boutique WooCommerce via l'API REST. Il garde ensuite une copie locale de ces données afin de continuer à fonctionner même si votre connexion Internet est instable. Cette approche rend le POS plus rapide et plus fiable dans un environnement de caisse chargé.

Cependant, cela signifie que notre POS ne "voit" pas les changements qui se produisent dynamiquement sur votre site en temps réel. Par exemple :

Type de pluginPourquoi il ne fonctionne pas
Tarification dynamique

Si un autre plugin sur votre boutique calcule un prix unique pour chaque client connecté, le POS ne recevra pas automatiquement ce prix personnalisé.

Add-ons de produit

Si un autre plugin sur votre boutique ajoute des données supplémentaires pour le produit, le POS ne recevra pas automatiquement ces données. Le POS ne reçoit que les données qui sont exposées via l'API REST.

Étapes suivantes

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