Endpoint REST

Définition : Un endpoint REST combine une route WordPress, une méthode HTTP et un traitement serveur. Il définit les arguments acceptés, la permission requise et la réponse produite pour une opération précise.

Comprendre et utiliser

À quoi sert cette notion ?

Il représente l’opération réellement exécutable : lire, créer, mettre à jour ou supprimer une ressource selon son contrat. Une même route peut exposer plusieurs endpoints.

Fonctionnement technique

WordPress sélectionne le gestionnaire adapté à la méthode reçue et lui fournit un objet WP_REST_Request. Le gestionnaire renvoie un objet réponse, des données convertibles ou une erreur.

Dans quel contexte l’utiliser ?

Une route /atoolpha/v1/notes peut proposer GET pour lister des notes et POST pour en créer une, avec des contrôles distincts.

Étude de cas : application professionnelle

Dans un projet évolutif, commencer par écrire un tableau d’opérations : consulter une liste, lire une fiche, créer une fiche, modifier une fiche, supprimer une fiche. Attribuer une méthode HTTP, un schéma d’entrée et une capacité à chaque ligne. Cela clarifie immédiatement le rôle des endpoints et les tests à prévoir. L’interface JavaScript peut alors afficher une liste en lecture seule sans charger les contrôles de modification pour les personnes non autorisées. Les erreurs d’accès doivent rester décidées par le serveur, pas simplement par l’interface.

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
POST /wp-json/wp/v2/posts

Décryptage du code et résultat attendu

La paire illustre deux opérations sur une même collection. La seconde exige des droits appropriés et un corps de requête valide ; elle n’est pas exécutable comme un simple accès public.

Exercice guidé pour vérifier la notion

Inspecter OPTIONS sur une collection de test et noter séparément les opérations GET et POST, avec leurs paramètres requis.

Précautions et limites

Ne pas annoncer qu’un endpoint est accessible parce qu’une URL répond. Documenter les méthodes, le schéma, les statuts HTTP et les conditions d’autorisation.

À ne pas confondre

Une route nomme une ressource ; un endpoint décrit une action HTTP précise exécutée sur cette route.

Diagnostic avancé

En cas de méthode refusée, comparer le verbe envoyé aux méthodes déclarées. Un échec de permission doit être analysé séparément d’une erreur de validation.