Tutoriel : Configurer une API WordPress pour l’automatisation

Cet article explique le principe de fonctionnement d’une API REST de WordPress et comment la configurer pour l’associer avec une application tierce dans le but d’automatiser des fonctions.

Liste des principales étapes décrites dans la suite de ce guide pour configurer une API REST de WordPress :

• Comprendre l’utilité primordiale de l’API REST de WordPress
• Configurer l’API REST de WordPress
• Supprimer l’API REST de WordPress

Comprendre l’utilité primordiale de l’API REST de WordPress

L’API (Application Programming Interface) REST (Representational State Transfer) de WordPress est un ensemble de règles et de protocoles qui permet à différentes applications externes de communiquer avec WordPress, offrant un moyen simple et structuré d’interagir avec les données d’un site WordPress.

Ce composant agit comme un pont, permettant à des applications externes de lire, créer, mettre à jour ou supprimer du contenu directement sur un site WordPress, sans avoir besoin d’une intervention humaine.

Concrètement, il peut servir à :

• Créer des applications mobiles iOS ou Android qui affichent le contenu du blog WordPress.
• Construire des frameworks frontend comme React, Vue.js ou Angular pour créer des interfaces utilisateur personnalisées, tout en utilisant WordPress comme « back-end ».
• Synchronisez des données d’un site WordPress avec un CRM, une plateforme marketing, un système de gestion de stocks ou tout autre service tiers.
• Automatiser des tâches en créant ou modifiant des articles, des pages, des utilisateurs ou des commentaires de manière automatisée.

L’API REST de WordPress offre une grande flexibilité grâce au découplage entre frontend et backend, une bonne évolutivité, une forte interopérabilité avec les technologies modernes, une amélioration de l’expérience utilisateur, notamment via des applications rapides et fluides et facilite le développement mobile, mais elle présente aussi des inconvénients comme une certaine complexité pour les débutants, la nécessité de porter une attention particulière à la sécurité, des risques de performance en cas de mauvaise optimisation, la gestion les évolutions de versions de l’API et une configuration parfois délicate, notamment pour les accès authentifiés.

Elle fonctionne en s’appuyant sur des requêtes HTTP standards (GET pour récupérer des données, POST pour en créer, PUT pour les modifier et DELETE pour les supprimer) envoyées vers des endpoints, c’est-à-dire des URL spécifiques représentant des ressources comme des articles ou des utilisateurs, tout en échangeant les informations au format JSON, un format léger et facilement lisible, et en adoptant un fonctionnement dit stateless où chaque requête est totalement indépendante des autres, ce qui simplifie la communication entre le client et le serveur, améliore la robustesse du système et facilite son évolutivité.

Configurer l’API REST de WordPress

L’énorme avantage de l’API REST, c’est qu’elle est intégrée nativement à WordPress depuis la version 4.7 et qu’elle est activée par défaut, donc il n’y a pas besoin d’installer un plugin supplémentaire pour la plupart de ses fonctionnalités de base.

Vérifier l’accès à l’API

Pour commencer, il est possible de vérifier que l’API est active en visitant l’URL suivante dans votre navigateur :

http://nom-de-domaine.fr/wp-json/
(A modifier selon la véritable adresse de votre site web).

Vous devriez voir une page avec du contenu JSON décrivant les points de terminaison (endpoints) disponibles sur ce site.

Ces requêtes sont pour utilisés pour la lecture de données et ne nécessitent généralement pas d’authentification.

Étapes pour configurer un mot de passe d’application

Pour des opérations qui modifient le contenu (créer, mettre à jour, supprimer des articles, pages, utilisateurs, etc.), l’API exige une authentification.

Depuis WordPress 5.6, la méthode la plus simple et sécurisée pour un utilisateur spécifique est d’utiliser les Mots de passe d’application (Application Passwords).

1. Pour commencer, il faut se connecter à l’interface d’administration de WordPress en tant qu’administrateur.http://nom-de-domaine.fr/wp-login/(A modifier selon la véritable adresse de votre site web).
2. Une fois connecté à l’interface d’administration de WordPress, dans la barre latérale de gauche, cliquer sur « Comptes > Ajouter ».
   Puis créer un compte utilisateur qui dispose des autorisations nécessaires pour les actions que l’API doit effectuer.Par exemple : Un rôle d’éditeur pour créer des articles ou d’administrateur pour des actions plus larges.
3. Aller tout en bas de la page du compte de cet utilisateur, jusqu’à la section « Nouveau mots de passe d’application ».
   Dans le champ « Nom du nouveau mot de passe d’application », saisir un nom descriptifPar exemple :
   • « Application Mobile »
   • « Intégration CRM »
   • « Mon Application Vue.js »
   • Cliquez sur le bouton « Ajouter un nouveau mot de passe d’application ».

   Cliquer sur le bouton « Ajouter un nouveau mot de passe d’application ».

   

4. WordPress générera et affichera un mot de passe unique. Attention : C’est le seul moment où ce mot de passe sera affiché.Il faut donc le copier immédiatement et le stocker en toute sécurité.
   Ce mot de passe sera utilisé pour authentifier l’interface WordPress auprès de l’API depuis des applications tierces.Les mots de passe d’application offrent un moyen sécurisé d’accorder un accès programmatique à votre site sans exposer votre mot de passe principal, et permettent de révoquer facilement l’accès pour une application spécifique sans affecter les autres.

Supprimer l’API REST de WordPress

Dans le cadre de la gestion de l’API REST, il est possible de révoquer (supprimer) les mots de passe d’application, si vous ne les utilisez plus ou si vous suspectez une compromission de sécurité.

Pour cela, il faut se connecter sur l’interface d’administration de WordPress et dans la barre latérale de gauche, cliquer sur « Comptes > Tous les comptes ».

Sélectionner le compte utilisateur qui intègre l’API REST et aller tout en bas de la page, jusqu’à la section « Nouveau mots de passe d’application ».

Cliquer sur le bouton « Révoquer » ou sur le bouton « Révoquer tous les mots de passe d’application » qui se trouvent au niveau du tableau correspondant.

L’API REST de WordPress est un outil révolutionnaire qui transforme un simple système de gestion de contenu en une plateforme de données puissante et polyvalente.

Elle permet de construire des expériences web modernes, des applications mobiles dynamiques et des intégrations fluides avec d’autres systèmes, bien qu’elle requière une certaine expertise technique pour être exploitée pleinement.

TAGS: WordPress API, REST API, API WordPress, Headless CMS, Développement web, Authentification API, Mots de passe d’application, Intégration WordPress, Applications mobiles, WordPress JSON