# WooCommerce REST API : fonctionnement

L’API REST de WooCommerce vous permet l’accès à distance à la zone d’administration de votre boutique WooCommerce. Les opérations de base telles que « Lire » ou « Créer » **sont gérées par des requêtes HTTP**. L’API REST de WooCommerce peut être activée directement dans le back-end.

## Qu’est-ce qu’une API REST ?

Les ressources d’un système pouvant être adressées par [REST](https://www.ionos.fr/digitalguide/serveur/know-how/rest-la-solution-http-pour-les-services-web/ "REST : la solution HTTP pour les services Web") (**Re**presentational **S**tate **T**ransfers) sont définies dans une [API](https://www.ionos.fr/digitalguide/sites-internet/developpement-web/quest-ce-quune-api/). Une telle interface fait partie des meilleures solutions permettant aux systèmes compatibles avec le Web de communiquer de manière simple et efficace entre le Client et le Serveur.

Chaque ressource se voit attribuer des paramètres qui la décrivent tout en pouvant être modifiés. Les architectures REST sont réalisées **à l’aide du protocole HTTP,** toutes les ressources pouvant être adressées via un **URI unique** (Uniform Ressource Identifier). Les paramètres sont ajoutés en tant que paramètres URL, et l’accès aux ressources se fait par les actions HTTP standard GET, POST, PUT et DELETE.

## À quoi sert une API REST dans WooCommerce ?

La caractéristique la plus importante de l’API de WooCommerce pour des accès REST est son universalité. Elle a été conçue pour permettre à une boutique WooCommerce d’interagir facilement avec d’autres sites ou services sur Internet. Cette interactivité polyvalente avec d’autres applications Web ne profite pas seulement aux développeurs, mais aussi à tous les utilisateurs de la plateforme de boutique, comme le prouvent ces exemples des **avantages d’utilisation de l’API de WooCommerce** :

- **Accès indépendant de la plateforme** : accéder directement au tableau de bord WooCommerce avec une application tierce ? C’est possible grâce à l’API REST.
- **Intégration facile de la logique commerciale** : l’API REST de WooCommerce permet d’intégrer facilement dans le projet des logiciels et du matériel spécifiques à l’entreprise, tels que des wearables ou les dispositifs de suivi IoT.
- **Synchronisation optimisée de données** : les entreprises qui souhaitent synchroniser des données sur différentes plateformes et canaux avec leur boutique WooCommerce disposent de l’interface adéquate avec l’API REST.
- **Indépendance vis-à-vis du back-end WooCommerce** : en activant l’API de WooCommerce universelle, vous vous rendez indépendant du back-end de WooCommerce ou de WordPress. Vous pouvez à tout moment intégrer et utiliser votre propre espace d’administration.
- **Intégration facile de données de tiers** : l’interface REST vous permet d’accéder facilement à l’ensemble des données de tiers basées sur l’application.
- **Lien avec des applications mobiles** : relier votre boutique WooCommerce à une application mobile est nettement plus facile en passant par l’interface polyvalente.

Conseil Vous êtes à la recherche d’un nouvel environnement matériel ou d’un environnement matériel adapté à votre boutique ? L’[hébergement WooCommerce](https://www.ionos.fr/solutions-ecommerce/hebergement-woocommerce "Hébergement pour WooCommerce pour e-boutiques de IONOS") de IONOS vous offre une base sûre et fiable pour votre projet de boutique en ligne à un prix avantageux !

## Comment utiliser l’API REST de WooCommerce : instructions pas à pas

Si vous souhaitez utiliser l’API de WooCommerce pour interagir avec d’autres applications et services Web, vous devez d’abord l’activer en générant une clé API. De plus, il faut installer un Client pour l’accès REST. Nous avons résumé les différentes étapes pour vous dans les paragraphes suivants.

### Étape 1 : générer une clé API REST dans WooCommerce

Pour utiliser l’API REST de WooCommerce, vous devez d’abord générer une clé API. Cette clé représente une sorte de contrôle d’accès et sera utilisée ultérieurement par WooCommerce pour **authentifier des requêtes REST**.

Voici comment générer une clé :

1. Connectez-vous au back-end de WooCommerce ou de WordPress.
2. Appelez la position « **WooCommerce** » du menu latéral gauche.
3. Cliquez sur « **Réglages** »
4. Passez à l’onglet « **Avancé** ».
5. Sélectionnez la sous-rubrique « API REST ».
6. Cliquez sur « **Ajouter une clé** » ou « **Créer une clé API** ».

[![Image: WooCommerce : menu API REST dans le back-end](https://www.ionos.fr/digitalguide/fileadmin/_processed_/c/7/csm_woocommerce-rest-api-menu-backend_3c705105c0.webp "WooCommerce : menu API REST dans le back-end")](https://www.ionos.fr/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-menu-backend.jpg) WooCommerce : menu API REST dans le back-end Trois caractéristiques sont à saisir pour la clé : sous « **Description** », vous inscrivez une brève information qui vous permettra de reconnaître la clé. Sur la ligne « **Utilisateur** », vous sélectionnez l’utilisateur WooCommerce pour lequel l’accès à l’interface doit être généré. Déterminez sous « **Droits** » si l’utilisateur doit avoir un accès seul en lecture ou en écriture, ou les deux.

Dès que vous confirmez vos saisies en cliquant sur « **Générer une clé API** », WooCommerce crée deux chaînes de caractères alphanumériques, une clé client et une clé secret client, ainsi qu’un QRCode. Copiez les deux clés et enregistrez les chaînes de caractères dans un document. Vous en aurez besoin ultérieurement lorsque vous souhaiterez accéder à l’API WooCommerce avec un Client REST.

[![Image: WooCommerce : clé client, clé secret client et QRCode](https://www.ionos.fr/digitalguide/fileadmin/_processed_/6/9/csm_woocommerce-rest-api-consumer-key-secrect-qr-code_074959f0d2.webp "WooCommerce : clé client, clé secret client et QRCode")](https://www.ionos.fr/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-consumer-key-secrect-qr-code.jpg) WooCommerce : clé client, clé secret client et QRCode. ### Étape 2 : télécharger l’API Client

Une fois une clé générée, vous pouvez envoyer vos requêtes à l’interface du système de boutique. Cependant, il faut disposer d’un Client API qui permette d’**envoyer des requêtes et d’afficher les réponses** reçues.

Les Clients les plus populaires pour l’accès REST sont [Insomnia](https://insomnia.rest/download "Site web de l’API Client Insomnia : téléchargement") et [Postman](https://www.postman.com/ "Site web de l’API Client Postman"). Les deux outils sont disponibles sous forme d’application de bureau pour Windows, macOS et Linux. Vous pouvez également utiliser **Postman**, que nous utilisons dans le cadre de notre tutoriel, comme application Web directement dans le navigateur.

L’installation et la configuration de Postman fonctionnent comme suit :

1. Appelez la [page de téléchargement de Postman](https://www.postman.com/downloads/ "Page de téléchargement de l’API Client Postman") et téléchargez la version correspondant à votre système.
2. Exécutez le fichier de configuration Postman en double-cliquant dessus.
3. Créez un compte Postman en saisissant une adresse email valide, un nom d’utilisateur et un mot de passe. Vous pouvez aussi vous inscrire à l’aide d’un compte Google actif.
4. Saisissez les informations demandées et envoyez des liens d’invitation à vos collègues (si vous le souhaitez).

[![Image: Capture d’écran du Client Postman](https://www.ionos.fr/digitalguide/fileadmin/_processed_/3/7/csm_woocommerce-rest-api-postman-client_d71be02730.webp "Capture d’écran du Client Postman")](https://www.ionos.fr/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-postman-client.jpg) Capture d’écran du Client Postman  Conseil Vous cherchez encore une adresse Internet appropriée pour votre projet WooCommerce ? Enregistrez dès aujourd’hui votre [nom de domaine](https://www.ionos.fr/domaine/noms-de-domaine "Noms de domaine : réservez un domaine Internet avec IONOS") personnalisé chez IONOS et obtenez un certificat SSL/TLS gratuit ainsi qu’un verrouillage de transfert de domaine pour votre boutique WooCommerce !

### Étape 3 : lancer une requête API WooCommerce

Après la configuration, vous pouvez tester l’accès à l’API REST en envoyant une première requête. Pour ce faire, accédez à votre espace de travail et cliquez sur « **Create new Request** » (« Créer une nouvelle requête »).

[![Image: Créer une nouvelle requête dans Postman](https://www.ionos.fr/digitalguide/fileadmin/_processed_/d/6/csm_woocommerce-rest-api-new-requests_bc8d349580.webp "Créer une nouvelle requête dans Postman")](https://www.ionos.fr/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-new-requests.jpg) Client Postman : créer une nouvelle requête API dans votre propre espace de travail en cliquant sur « Create new Request ». Pour le premier test, nous sélectionnons une **requête GET** pour appeler des données. Dans Postman, cette méthode est sélectionnée par défaut, vous pouvez donc conserver ce choix. Sur la **ligne d’adresse** suivant le « GET », au lieu de *woocommerce-domain.xyz*, utilisez l’adresse de votre boutique WooCommerce :

```none
https://woocommerce-domain.xyz/wp-json/wc/v3/orders
```

Ensuite, insérez vos données pour l’authentification à l’aide de l’API REST de WooCommerce. Il s’agit ici de savoir si l’accès REST se fait par HTTP ou HTTPS (recommandé). Passez à l’onglet « **Authorization** » (« Autorisation ») et, sous « **Type** », sélectionnez soit « OAuth 1.0 » pour HTTP ou « Basic Auth » pour HTTPS. Saisissez ensuite les codes enregistrés pour votre clé client et votre clé secret client. Dans le cas de Basic Auth, la clé doit être saisie sous « Username » (« Nom utilisateur ») et la clé secret sous « Password » (« Mot de passe »).

[![Image: Capture d’écran de Postman : indication de la clé API et du secret API](https://www.ionos.fr/digitalguide/fileadmin/_processed_/5/f/csm_woocommerce-rest-api-authorization-using-https_65983ba609.webp "Capture d’écran de Postman : indication de la clé API et du secret API")](https://www.ionos.fr/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-authorization-using-https.jpg) Capture d’écran de Postman : indication de la clé API et du secret API Une fois l’authentification configurée, vous appuyez sur le bouton « **Send** » (« Envoyer ») et la requête est lancée. Dans le cas de l’adresse définie ci-dessus, vous appelez toutes les commandes actuelles avec la requête GET. **Postman présente le résultat dans la fenêtre inférieure** au choix dans les formats JSON, XML, HTML ou Texte.

[![Image: Postman : résultat édité pour la requête GET des commandes actuelles](https://www.ionos.fr/digitalguide/fileadmin/_processed_/0/5/csm_woocommerce-rest-api-response-get-request_49aa2f3530.webp "Postman : résultat édité pour la requête GET des commandes actuelles")](https://www.ionos.fr/digitalguide/fileadmin/DigitalGuide/Screenshots_2023/woocommerce-rest-api-response-get-request.jpg) Postman : résultat édité pour la requête GET des commandes actuelles  Conseil Vous trouverez dans le Digital Guide de nombreux autres articles passionnants sur WordPress et le plugin de boutique populaire WooCommerce :

- [WordPress REST API](https://www.ionos.fr/digitalguide/hebergement/blogs/wordpress-rest-api/ "WordPress REST-API")
- [Thèmes WooCommerce](https://www.ionos.fr/digitalguide/hebergement/cms/themes-woocommerce/ "Thèmes WooCommerce")
- [Paiements WooCommerce](https://www.ionos.fr/digitalguide/hebergement/cms/paiements-woocommerce/ "Paiements WooCommerce")
- [Plugins WooCommerce](https://www.ionos.fr/digitalguide/hebergement/cms/plugins-woocommerce/ "Plugins WooCommerce")
- [Shortcodes WooCommerce](https://www.ionos.fr/digitalguide/hebergement/cms/shortcodes-woocommerce/ "Shortcodes WooCommerce")


This is a markdown version of: [https://www.ionos.fr/digitalguide/hebergement/cms/woocommerce-rest-api/](https://www.ionos.fr/digitalguide/hebergement/cms/woocommerce-rest-api/) for AI/LLM consumption.