Guide d'utilisation de l'API REST de WooCommerce : Un processus complet pour se connecter à des systèmes externes

WooCommerce L'API REST est un système d'interface puissant et flexible pour les utilisateurs et les développeurs qui souhaitent connecter leur boutique à des services tiers. Cet article vous aidera à comprendre API REST L'utilisation de base, le processus de génération des clés et le dépannage des problèmes courants.

Qu'est-ce que l'API REST de WooCommerce ?

il est WooCommerce Une interface fournie pour interagir avec des systèmes externes (par exemple, ERP, APP, applets, systèmes d'inventaire, etc.) pour les marchandises, les commandes, les clients et d'autres données. Dans la plupart des cas, la connexion peut être établie simplement en générant une clé API et en la saisissant dans un système tiers.

Mise en route : configuration du lien fixe

L'API REST s'appuie sur la structure des liens fixes de WordPress pour fonctionner. Avant de commencer, vérifiez que le format des liens fixes du site est défini sur autre chose que "plain text".

Trajectoire :
WordPress Backend > Settings > Fixed Links
Option recommandée : format "jour et nom" ou autre format structuré

Etape 1 : Générer la clé API de WooCommerce

WooCommerce utilise un mécanisme de clés pour gérer les droits d'accès. Chaque ensemble de clés est lié à un utilisateur WordPress.

La procédure est la suivante :

Connectez-vous au backend de WordPress
Allez dans WooCommerce > Paramètres > Avancés > REST API
Si vous utilisez une version de WooCommerce antérieure à la 3.4, le chemin d'accès est : Paramètres > API > Clé/Applications
Cliquez sur "Ajouter une clé".

Complétez les informations ci-dessous :
- Description : donner un nom à la clé pour faciliter son identification
- Utilisateur : Sélectionnez un utilisateur WordPress
- Permissions :
  - Lire (lecture seule)
  - Écrire
  - Lecture/écriture
Cliquez sur "Generate API Key".

Le système fournira les éléments suivants :

Clé du consommateur
Secret des consommateurs
code-barres bidimensionnel
Bouton d'annulation

Après avoir introduit la clé et l'adresse du site dans le système externe, la connexion est établie.

Étape 2 : Tester l'API

Les liens suivants peuvent être testés dans un navigateur ou à l'aide des outils Postman :

https://yourdomain.com/wp-json/wc/v3/orders?consumer_key=ck_xxx&consumer_secret=cs_xxx

Si vous obtenez une erreur 401 ou le message "woocommerce_rest_cannot_view", veuillez vérifier les éléments suivants :

La clé est-elle correcte ?
Si les autorisations sont définies sur "lecture/écriture" ou non.
Si le serveur a transmis correctement les informations d'authentification

Pour confirmer que le serveur prend en charge l'en-tête Auth, vous pouvez également ajouter temporairement un nouvel en-tête Auth à l'en-tête .htaccess Ajouter ce qui suit au

SetEnvIf Autorisation . + HTTP_AUTHORIZATION=$0
RewriteRule ^wp-json/. * - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]

API REST héritée (interface héritée)

WooCommerce a déjà utilisé Legacy REST. API après WooCommerce 9.0, cette fonctionnalité sera migrée vers un plugin autonome.

S'il existe encore une dépendance actuelle de l'ancien système, vous pouvez l'activer de la manière suivante :

Accès aux coulisses :WooCommerce > Réglages > Avancés > Legacy API
Cochez "Activer l'API REST héritée".

La nouvelle version de l'API REST avec WordPress L'intégration du système natif est activée par défaut, il est donc recommandé de migrer vers la nouvelle version.

Questions fréquemment posées

Q : Erreur 401 ou "woocommerce_rest_cannot_view" lors de la demande ?
Veuillez cocher les cases suivantes :

La clé API est-elle correcte ?
Si les autorisations sont définies en lecture ou en écriture
Pour vérifier si les informations d'authentification sont transmises correctement, essayez d'ajouter la clé aux paramètres de l'URL.

résumés

L'API WooCommerce REST offre de puissantes capacités d'interaction de données, applicables à la synchronisation de l'inventaire, à l'envoi de commandes, à l'interface APP et à d'autres scénarios. Vous n'avez qu'à compléter la génération de la clé, la configuration des permissions et les tests de base, puis vous pouvez commencer le processus de connexion aux systèmes externes en douceur.

Si vous cherchez un moyen automatisé et évolutif d'interfacer avec les données de votre boutique, l'API REST est un outil important de WooCommerce qui ne peut pas être ignoré.

Contactez nous
Vous n'arrivez pas à lire le tutoriel ? Contactez-nous pour une réponse gratuite ! Aide gratuite pour les sites personnels et les sites de petites entreprises !	Service clientèle WeChat
① Tel : 020-2206-9892
② QQ咨询：1025174874
(iii) Courriel : info@361sale.com
④ Horaires de travail : du lundi au vendredi, de 9h30 à 18h30, jours fériés.