{"id":69414,"date":"2022-10-20T14:06:02","date_gmt":"2022-10-20T21:06:02","guid":{"rendered":"https:\/\/dhblog.dream.press\/blog\/?p=69414"},"modified":"2025-05-26T07:56:31","modified_gmt":"2025-05-26T14:56:31","slug":"une-introduction-lapi-rest-de-wordpress-fr","status":"publish","type":"post","link":"https:\/\/www-dev.dreamhost.com\/blog\/fr\/une-introduction-lapi-rest-de-wordpress-fr\/","title":{"rendered":"Une Introduction \u00e0 l\u2019API REST de WordPress"},"content":{"rendered":"\n

Quand l’API REST a finalement \u00e9t\u00e9 ajout\u00e9e au noyau de WordPress<\/a>, c’\u00e9tait la fin d’un long voyage. Beaucoup avaient anticip\u00e9 ce changement comme le plus grand pas en avant pour WordPress dans l’histoire de la plateforme. Cependant, si tu n’es pas familier avec l’API REST, tu pourrais \u00eatre confus quant \u00e0 ce que tout cela signifie.<\/p>\n\n\n

En r\u00e9sum\u00e9, l’ajout de l’API REST WordPress<\/a> a transform\u00e9 WordPress en un framework d’application complet. Cela a consid\u00e9rablement augment\u00e9 son \u00ab extensibilit\u00e9 \u00bb, ou sa capacit\u00e9 \u00e0 \u00eatre \u00e9tendu avec de nouvelles fonctionnalit\u00e9s et capacit\u00e9s. De plus, cela a \u00e9largi le potentiel de la plateforme pour communiquer avec d’autres sites et applications.<\/p>\n\n\n

Une Introduction Aux REST APIs<\/b><\/h2>\n\n\n

Avant de nous plonger plus profond\u00e9ment dans l’API REST de WordPress, il est important de clarifier notre terminologie. C’est un sujet o\u00f9 nous devrons utiliser beaucoup d’acronymes, alors clarifions-les tout de suite.<\/p>\n\n\n

Tout d’abord, tu dois savoir ce que sont les Interfaces de Programmation d’Applications (API)<\/a>. En termes simples, une API est un moyen par lequel un syst\u00e8me permet \u00e0 d’autres syst\u00e8mes de se connecter \u00e0 ses donn\u00e9es.<\/p>\n\n\n

Par exemple, lorsqu’un site web ajoute un bouton \u00ab J’aime \u00bb de Facebook \u00e0 une page, il le fait en se connectant \u00e0 l’API de Facebook. Cela permet \u00e0 la page web d’utiliser l’API pour recevoir des donn\u00e9es (le code du bouton J’aime) et envoyer des donn\u00e9es (la demande de J’aime).<\/p>\n\n\n

Alors, qu’est-ce qu’une API REST sp\u00e9cifiquement ? Representational State Transfer (REST)<\/a> est un type d’API sp\u00e9cifique aux services web. Elle contient un ensemble standardis\u00e9 d’instructions et de r\u00e8gles, facilitant ainsi la connexion entre tous les services \u00ab RESTful \u00bb.<\/p>\n\n\n

En r\u00e9sum\u00e9, les API REST te permettent de faire des demandes \u00e0 un syst\u00e8me externe. Un exemple de cela est Twitter. Tu peux utiliser son API pour demander un certain nombre de tweets d’un utilisateur sp\u00e9cifique. L’API te retournera ensuite les tweets en fonction de ta demande, que tu peux int\u00e9grer sur ton site en utilisant HTML<\/a> et CSS<\/a>.<\/p>\n\n\n

Ces demandes sont effectu\u00e9es en utilisant la Notation des Objets JavaScript (JSON)<\/a>. Il s’agit d’un langage sp\u00e9cifiquement con\u00e7u pour l’envoi, la r\u00e9ception et le stockage de donn\u00e9es.<\/p>\n\n\n

Nous allons aborder JSON plus tard dans cet article, mais nous te recommandons de prendre le temps de te familiariser d\u00e8s maintenant avec ce langage. Cela t’aidera \u00e0 te pr\u00e9parer pour utiliser l’API REST de WordPress et \u00e0 comprendre certains des concepts dont nous parlerons.<\/p>\n\n\n

Ce Qu’Est L’API REST WordPress (Et Pourquoi C’Est Important)<\/b><\/h2>\n\n
\n
\"WordPress<\/figure><\/div>\n\n

La WordPress REST API<\/a> fonctionne de mani\u00e8re tr\u00e8s similaire aux exemples que nous avons d\u00e9j\u00e0 abord\u00e9s. Fondamentalement, la WordPress REST API te donne un acc\u00e8s complet aux fonctionnalit\u00e9s de WordPress depuis n’importe quel framework compatible JSON.<\/p>\n\n\n

De la m\u00eame mani\u00e8re que l\u2019API de Twitter vous permet de r\u00e9cup\u00e9rer et d’envoyer des tweets, l\u2019API REST de WordPress peut \u00eatre utilis\u00e9e pour g\u00e9rer des articles, des utilisateurs, des cat\u00e9gories, et bien plus depuis des plateformes externes. Elle vous permet d’utiliser WordPress de plusieurs mani\u00e8res jusqu’alors in\u00e9dites.<\/p>\n\n\n

L’API REST a \u00e9t\u00e9 annonc\u00e9e<\/a> d\u00e8s 2013. Elle a commenc\u00e9 sa vie comme un plugin<\/a>, destin\u00e9e \u00e0 \u00eatre int\u00e9gr\u00e9e au noyau de WordPress dans la version 4.1. Comme cela arrive souvent, des retards ont repouss\u00e9 la sortie jusqu’\u00e0 ce qu’elle soit finalement mise en \u0153uvre dans le noyau avec la sortie de WordPress 4.7<\/a> trois ans plus tard.<\/p>\n\n\n

C’\u00e9tait une longue attente, mais cela en valait la peine pour de nombreuses personnes qui voyaient l’API REST de WordPress comme un pas important en avant pour la plateforme. Tu te demandes peut-\u00eatre pourquoi cette addition \u00e9tait une si grande affaire, surtout que beaucoup d’utilisateurs n’ont probablement pas remarqu\u00e9 beaucoup de diff\u00e9rence. En r\u00e9alit\u00e9, l’inclusion de l’API REST constituait un changement fondamental pour WordPress pour de nombreuses raisons.<\/p>\n\n\n

En mettant en \u0153uvre une API REST, WordPress s’est d\u00e9tach\u00e9 de son statut de simple plateforme de cr\u00e9ation de sites web. Il est d\u00e9sormais devenu un framework d’application \u00e0 part enti\u00e8re. Cela signifie que les d\u00e9veloppeurs peuvent utiliser un site WordPress pour cr\u00e9er des applications pour appareils mobiles et pour le web ou comme un d\u00e9p\u00f4t d’informations.<\/p>\n\n\n

Ce changement a \u00e9galement permis \u00e0 WordPress de s’\u00e9loigner de sa d\u00e9pendance au PHP<\/a>. En rendant WordPress compatible avec tout langage compatible JSON, l’API REST a consid\u00e9rablement \u00e9largi les possibilit\u00e9s pour les d\u00e9veloppeurs, leur permettant d’utiliser les fonctionnalit\u00e9s de WordPress avec pratiquement n’importe quel framework.<\/p>\n\n\n

Enfin, l’API REST offre une flexibilit\u00e9 accrue avec les interfaces que tu peux utiliser pour travailler avec la plateforme. Elle a rendu l’interface d’administration compl\u00e8tement optionnelle puisque tu peux maintenant interagir avec ton site WordPress enti\u00e8rement via des commandes JSON.<\/p>\n\n\n

Maintenant, regardons comment JSON et l’API REST se combinent pour rendre cela possible.<\/p>\n\n\n

Comment L’API REST Et Le JSON Fonctionnent Ensemble<\/b><\/h2>\n\n\n

\u00c0 pr\u00e9sent, tu devrais ma\u00eetriser les aspects th\u00e9oriques de l’API REST de WordPress. Alors, examinons le c\u00f4t\u00e9 plus pratique de la technologie. Le manuel officiel<\/a> d\u00e9crit l’utilisation de l’API REST comme suit :<\/p>\n\n\n

\u00ab L’API REST de WordPress fournit des points de terminaison d’API pour les types de donn\u00e9es WordPress qui permettent aux d\u00e9veloppeurs d’interagir avec les sites \u00e0 distance, en envoyant et recevant des objets JSON (JavaScript Object Notation). \u00bb<\/p>\n\n\n

Le premier mot sur lequel nous devons nous concentrer ici est \u00ab endpoints \u00bb. La mani\u00e8re la plus simple de penser \u00e0 un endpoint est comme une pi\u00e8ce de donn\u00e9es ou une fonction qui peut \u00eatre appel\u00e9e en utilisant une requ\u00eate JSON<\/a>. Par d\u00e9faut, WordPress propose un grand nombre de endpoints standards<\/a> \u00e0 utiliser, mais les d\u00e9veloppeurs peuvent \u00e9galement cr\u00e9er des endpoints personnalis\u00e9s<\/a>.<\/p>\n\n\n

Pour atteindre un point de terminaison, tu dois utiliser une \u2018route\u2019,<\/a> qui prend la forme d’une URL normale. Tu peux m\u00eame essayer cela toi-m\u00eame d\u00e8s maintenant.<\/p>\n\n\n

Rends-toi sur ton propre site WordPress, et ajoute \/wp-json\/wp\/v2<\/i> \u00e0 la fin de son URL. Si ton site est http:\/\/example.com<\/i>, tu entrerais http:\/\/example.com\/wp-json\/wp\/v2<\/i>.<\/p>\n\n\n

Lorsque tu charges cette route, tu atteindras le point de terminaison, qui dans ce cas, retourne tout le contenu et les m\u00e9tadonn\u00e9es de ton site dans un format JSON (d\u00e9sordonn\u00e9). En utilisant diff\u00e9rentes routes, tu peux acc\u00e9der \u00e0 diff\u00e9rents points de terminaison pour obtenir des types d’informations sp\u00e9cifiques et effectuer diverses t\u00e2ches.<\/p>\n\n\n

Il y a trois principales requ\u00eates JSON<\/a> que tu utiliseras avec l’API REST, alors jetons-y \u00e9galement un rapide coup d’\u0153il maintenant. Elles sont :<\/p>\n\n\n