REST API WordPress
Définition : La REST API WordPress expose des ressources du site au moyen de requêtes HTTP et de réponses JSON. Elle permet aux applications autorisées de consulter ou modifier des données sans charger une page HTML.
Comprendre et utiliser
À quoi sert cette notion ?
Elle sert de contrat d’échange entre WordPress et un programme externe ou l’interface JavaScript d’un bloc. Elle évite de lire directement les tables SQL depuis le client et réutilise les règles de permission du Core.
Fonctionnement technique
Le serveur associe une méthode HTTP et un chemin à un endpoint enregistré. Une requête est analysée, authentifiée si nécessaire, autorisée, puis dirigée vers une callback qui prépare une réponse structurée et son statut HTTP.
Dans quel contexte l’utiliser ?
Un outil documentaire ATOOLPHA peut lire des articles publiés pour construire un index externe, tandis qu’un outil de gestion doit s’authentifier avant de modifier une publication.
Étude de cas : application professionnelle
Pour comprendre une intégration réelle, imaginer un client qui doit afficher uniquement les articles publics d’un site. Il commence par découvrir l’API, demande une collection paginée et construit des liens à partir des URL renvoyées, sans accéder directement à MySQL. Si la même application propose une édition, elle ajoute une authentification et vérifie les permissions de l’utilisateur. Cette progression sépare nettement lecture publique, écriture autorisée et affichage. Tester ces trois états évite de confondre disponibilité de l’API et ouverture générale des données.
Exemple technique commenté
Les lignes ci-dessus sont des exemples de requêtes HTTP, non des commandes prêtes à coller dans un article. Pour les essayer, utiliser un client HTTP et un site de test. Toute opération d'écriture nécessite un compte autorisé, une authentification appropriée et une sauvegarde du jeu de données concerné.
GET /wp-json/wp/v2/posts?per_page=3
Accept: application/jsonDécryptage du code et résultat attendu
Cette requête lit une petite collection de publications exposées publiquement. Elle ne demande aucune modification ; le serveur renvoie une liste JSON et un code de réponse indiquant le résultat.
Exercice guidé pour vérifier la notion
Dans un environnement de test, ouvrir la route d’index de l’API, puis interroger trois publications et inspecter la structure JSON ainsi que le statut HTTP.
Précautions et limites
Ne présume pas que toute ressource exposée est publique ou modifiable : authentification et permission dépendent de la route. Les champs disponibles dépendent également du schéma et du contexte.
À ne pas confondre
L’API REST communique des données structurées ; l’API Rewrite transforme des URL, alors qu’AJAX désigne une technique de communication côté navigateur.
Diagnostic avancé
En cas de 404, contrôler l’URL, les permaliens et la disponibilité de la route. En cas de 401/403, examiner l’authentification et les capacités plutôt que de désactiver les contrôles.
Choix d’architecture et déploiement
Pour une intégration, versionner les routes personnalisées, limiter les données transmises et documenter les champs consommés. Éviter un couplage aux détails internes des tables WordPress.
