Découverte REST API (Discovery)
Définition : La découverte REST permet à un client de déterminer les routes, namespaces et capacités annoncés par une installation WordPress. Elle repose sur l’index de l’API et les métadonnées exposées.
Comprendre et utiliser
À quoi sert cette notion ?
Elle simplifie l’intégration sans coder en dur chaque URL. Un client peut trouver le point d’entrée principal puis parcourir les routes déclarées et leurs schémas.
Fonctionnement technique
L’index renvoyé par la racine REST contient notamment des informations sur le site, les namespaces et les routes accessibles à la découverte. Les données visibles peuvent varier selon l’authentification et les extensions.
Dans quel contexte l’utiliser ?
Avant de connecter un explorateur de contenus à ATOOLPHA, relever le préfixe REST et vérifier qu’une route attendue existe réellement.
Étude de cas : application professionnelle
Avant de connecter un tableau de bord à un site inconnu, commencer par interroger son index REST. Relever les namespaces réellement présents, puis demander les méthodes et schémas d’une route spécifique. Cette inspection indique ce que le serveur annonce, mais pas ce qu’un utilisateur donné pourra effectivement faire. Tester ensuite une lecture anonyme et une lecture authentifiée. Si les réponses diffèrent, comprendre quels contrôles s’appliquent au lieu de contourner la restriction. Documenter la route utilisée et les champs indispensables au client.
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/
Accept: application/jsonDécryptage du code et résultat attendu
L’index de découverte retourne des métadonnées et les routes enregistrées. Il ne signifie pas que toutes les opérations sont autorisées à un visiteur anonyme.
Exercice guidé pour vérifier la notion
Comparer l’index REST de deux environnements de test, puis vérifier la présence d’un namespace apporté par un plugin actif.
Précautions et limites
Ne pas traiter la présence d’une route comme une autorisation d’écriture ; inspecter le schéma et appliquer les contrôles de permissions lors de l’appel effectif.
À ne pas confondre
Découverte décrit le catalogue de routes ; documentation d’un endpoint expose les arguments d’une opération ; authentification détermine l’identité du demandeur.
Diagnostic avancé
Si le client utilise une URL fixe et échoue après migration, rechercher l’index via l’URL générée par WordPress plutôt que concaténer aveuglément /wp-json/.
Choix d’architecture et déploiement
La découverte est utile au diagnostic et au développement, mais les clients de production doivent rester tolérants aux champs additionnels et aux routes facultatives.
