1️⃣ Qu’est-ce que l’API REST de WordPress ?

L’API REST (Representational State Transfer) est une interface qui permet d’interagir avec un site WordPress via des requêtes HTTP.

💡 Exemples d’utilisations courantes :
✅ Récupérer des articles en JSON 📜
✅ Créer un système d’authentification sécurisé 🔐
✅ Intégrer WordPress avec une application mobile 📱
✅ Créer un front-end avec React, Vue.js ou Angular 🚀

L’API REST est activée par défaut sur tous les sites WordPress depuis la version 4.7 🎉.

---

2️⃣ Tester l’API REST de WordPress

📌 2.1 Accéder à l’API en lecture seule (GET)

Vous pouvez accéder à l’API REST sans authentification pour récupérer du contenu public.

🔹 Format général :

arduinoCopierModifierhttps://votre-site.com/wp-json/wp/v2/{ressource}

🔹 Exemple : Récupérer les articles du site

bashCopierModifierhttps://votre-site.com/wp-json/wp/v2/posts

🔹 Exemple : Récupérer les catégories

bashCopierModifierhttps://votre-site.com/wp-json/wp/v2/categories

🔹 Exemple : Récupérer un article spécifique (ID = 10)

bashCopierModifierhttps://votre-site.com/wp-json/wp/v2/posts/10

💡 Vous pouvez tester ces requêtes directement dans votre navigateur ou avec Postman.

---

3️⃣ Faire des requêtes API avec JavaScript et Fetch

Une requête simple en JavaScript avec fetch() :

jsCopierModifierfetch('https://votre-site.com/wp-json/wp/v2/posts')
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Erreur :', error));

📌 Cela récupère tous les articles et les affiche dans la console du navigateur.

---

4️⃣ Authentification et requêtes sécurisées (POST, PUT, DELETE)

Pour ajouter, modifier ou supprimer du contenu avec l’API, il faut une authentification.

📌 4.1 Méthodes disponibles

Méthode	Utilisation
GET	Lire des données
POST	Créer un nouvel élément
PUT/PATCH	Modifier un élément
DELETE	Supprimer un élément

📌 4.2 Authentification avec l’API REST

🔹 Trois méthodes principales :

1. Authentification par cookie (pour les utilisateurs connectés)
2. Jetons JWT (JSON Web Token) ✅ Méthode recommandée
3. Clés d’application OAuth (pour les intégrations avancées)

🛠 Installer JWT Authentication for WP-API

1. Installez le plugin JWT Authentication for WP REST API
2. Ajoutez ces lignes à wp-config.php :

phpCopierModifierdefine('JWT_AUTH_SECRET_KEY', 'votre_cle_secrete_ultra_secure');
define('JWT_AUTH_CORS_ENABLE', true);

3. Testez l’authentification en envoyant une requête POST à :

bashCopierModifierhttps://votre-site.com/wp-json/jwt-auth/v1/token

Avec ces données JSON dans le corps de la requête :

jsonCopierModifier{
  "username": "admin",
  "password": "mon_mot_de_passe"
}

📌 Réponse attendue :

jsonCopierModifier{
  "token": "votre_token_jwt",
  "user_email": "admin@example.com",
  "user_nicename": "admin",
  "user_display_name": "Admin"
}

Une fois le token obtenu, ajoutez-le dans vos requêtes :

jsCopierModifierfetch('https://votre-site.com/wp-json/wp/v2/posts', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer votre_token_jwt'
  },
  body: JSON.stringify({
    title: 'Mon Nouvel Article',
    content: 'Voici le contenu de mon article...',
    status: 'publish'
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Erreur :', error));

✅ Cet exemple crée un article sur WordPress en passant par l’API REST !

---

5️⃣ Filtrer et trier les résultats API

Vous pouvez personnaliser les requêtes API en ajoutant des paramètres :

📌 5.1 Récupérer les derniers articles (ordre décroissant)

bashCopierModifierhttps://votre-site.com/wp-json/wp/v2/posts?orderby=date&order=desc

📌 5.2 Récupérer un article spécifique par son slug

bashCopierModifierhttps://votre-site.com/wp-json/wp/v2/posts?slug=mon-article

📌 5.3 Récupérer seulement les articles d’une catégorie (ID = 3)

bashCopierModifierhttps://votre-site.com/wp-json/wp/v2/posts?categories=3

📌 5.4 Récupérer seulement 5 articles

bashCopierModifierhttps://votre-site.com/wp-json/wp/v2/posts?per_page=5

---

6️⃣ Créer des routes API personnalisées 🚀

Si vous développez un plugin ou un thème avancé, vous pouvez créer vos propres endpoints API REST.

Ajoutez ce code dans functions.php :

phpCopierModifierfunction api_hello_world() {
    return new WP_REST_Response(['message' => 'Hello World!'], 200);
}

add_action('rest_api_init', function () {
    register_rest_route('custom/v1', '/hello/', [
        'methods'  => 'GET',
        'callback' => 'api_hello_world',
    ]);
});

📌 Testez votre endpoint :

bashCopierModifierhttps://votre-site.com/wp-json/custom/v1/hello

✅ Réponse attendue :

jsonCopierModifier{
  "message": "Hello World!"
}

---

🎯 Conclusion : Pourquoi utiliser l’API REST de WordPress ?

✅ Créer une application mobile 📱
✅ Connecter WordPress à un CRM ou un autre site 🔗
✅ Développer un site WordPress headless (React, Vue, etc.) 🎨
✅ Automatiser la création de contenu 🤖
✅ Gérer WordPress depuis une autre interface 🖥️

L’API REST de WordPress est puissante et facile à utiliser. Grâce à ce guide, vous pouvez maintenant récupérer, ajouter, modifier et supprimer des données via WordPress comme un pro 💪🔥.

📌 Besoin d’aide ou d’exemples concrets ? Dites-moi en commentaire ! 😊