_embed (paramètre REST)
Définition : _embed est un paramètre global de l’API REST WordPress qui demande l’intégration de certaines ressources liées dans la réponse JSON. Il peut éviter plusieurs requêtes supplémentaires du client.
Comprendre et utiliser
À quoi sert cette notion ?
Il simplifie l’affichage d’informations liées comme l’auteur ou les termes d’une publication lorsque leurs liens sont exposés comme intégrables.
Fonctionnement technique
WordPress suit les liens de relations admissibles et ajoute un champ _embedded. Certaines relations peuvent être sélectionnées explicitement suivant les possibilités documentées.
Dans quel contexte l’utiliser ?
Une carte d’article doit montrer le titre et l’auteur sans lancer une nouvelle requête HTTP pour chaque élément de liste.
Étude de cas : application professionnelle
Une liste d’articles accompagnée de leurs auteurs peut entraîner une requête supplémentaire pour chaque ligne si le client interroge les relations une à une. _embed peut regrouper certaines données associées dans la réponse initiale. Comparer le nombre de requêtes réseau, puis vérifier la taille du JSON obtenu. Une intégration excessive peut au contraire ralentir l’application et transférer des informations inutilisées. Il faut donc choisir les relations réellement nécessaires et vérifier qu’elles sont déclarées intégrables par le serveur. Les permissions applicables restent inchangé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?_embed=author&per_page=3Décryptage du code et résultat attendu
L’appel demande la collection de publications et les données d’auteur pouvant être intégrées. Le contenu exact reste limité par les relations et les droits.
Exercice guidé pour vérifier la notion
Comparer le nombre de requêtes réseau et la taille des réponses avec et sans _embed sur trois publications.
Précautions et limites
Une réponse avec _embed peut devenir volumineuse. Les ressources privées restent soumises aux mécanismes de permission ; l’intégration ne doit pas servir à les contourner.
À ne pas confondre
_embed inclut certaines ressources associées ; _fields sélectionne des propriétés. Les deux peuvent être combinés avec attention.
Diagnostic avancé
Si _embedded est absent, vérifier la présence de relations intégrables dans _links et les champs éventuellement filtrés par _fields.
Choix d’architecture et déploiement
Privilégier un usage ciblé de _embed pour éviter des réponses redondantes dans les listes volumineuses.
