Comprendre l'API REST de WordPress : Un guide pour les développeurs

Intro

La création d'un site web est un processus complexe et en plusieurs étapes. Pour commencer, vous devez d'abord trouver une solution d'hébergement de qualité. Si vous allez créer un nouveau site web et que vous ne vous attendez pas à une demande très élevée de ressources et à un trafic très important, un serveur VPS est une solution polyvalente qui conviendra à la plupart des sites web. Si la méthode de paiement vous importe, sachez que vous pouvez choisir parmi une variété d'options, telles que le VPS avec carte de crédit, le VPS avec bitcoin, le VPS avec AliPay, etc.

Un autre aspect fondamental de la création d'un site web est le choix d'un CMS - système de gestion de contenu, un outil spécial utilisé pour remplir le site web de contenu et le modifier. Si vous avez choisi WordPress, vos développeurs devront utiliser l'API REST de WordPress.

Wordpress est l'un des systèmes de gestion de contenu (CMS) les plus populaires de nos jours pour la création de sites web. L'API REST est une interface essentielle utilisée pour travailler avec un site web Wordpress. Grâce à l'API REST, vos applications ont la possibilité d'interagir avec votre site web par le biais de fichiers JSON. Ainsi, les développeurs peuvent créer des applications, des sites web et des plugins personnalisés sur Wordpress. L'API REST permet aux développeurs d'interagir avec les données de Wordpress au moyen de commandes HTTP.

Dans ce qui suit, nous allons examiner quelques commandes essentielles qui seront utiles à tout développeur.

L'API REST de WordPress : L'essentiel

GET :

Elle est utilisée pour récupérer des données de la base de données de WordPress en utilisant la méthode HTTP GET. Cette commande est l'une des plus courantes, car c'est la première que vous utilisez avant de faire quelque chose avec vos données.

Il permet de récupérer une ressource spécifique telle qu'un article, une page ou un type d'article personnalisé sans la modifier.

Pour utiliser cette méthode, vous devez envoyer une requête à un point d'accès spécifique avec un ensemble donné de paramètres. Le point d'accès est présenté par une URL de la ressource avec les paramètres que vous souhaitez récupérer - par exemple, l'ID de la ressource, les options de filtrage, les informations de pagination et d'autres paramètres de requête.

Si vous tapez ceci :

GET http://yoursite.com/wp-json/wp/v2/posts/983

vous obtiendrez les détails de l'article avec cet identifiant particulier, tels que son titre, son contenu, son auteur et d'autres métadonnées.

En outre, vous pouvez obtenir des informations sur une liste de ressources. Par exemple, si vous voulez voir toutes les ressources publiées, vous devez ajouter /wp/v2/posts?status=publish à la requête du point final :

GET http://yoursite.com/wp-json/wp/v2/posts?status=publish

POST :

Cette commande est utilisée pour ajouter quelque chose de nouveau à votre site web. Il peut s'agir d'un article, mais elle peut également être utilisée pour des pages, des commentaires et d'autres pièces jointes.

Pour créer un nouveau message, ajoutez /wp/v2/posts au point de terminaison.

POST http://yoursite.com/wp-json/wp/v2/posts

Ensuite, dans le payload, vous pourrez inclure les données du nouvel article, telles que son titre, son contenu, son auteur et d'autres métadonnées :

"title" : "My New Post", "content" : "This is the content of my new post", "author" : 1, "status" : "publish"

PUT :

POST est utilisé pour créer des brouillons vides pour les pages et les articles. Pour mettre à jour un brouillon avec du nouveau contenu, vous pouvez utiliser la commande PUT. Cette commande peut également être utilisée pour publier des versions préliminaires créées précédemment.

Pour afficher tous les projets en cours, vous pouvez utiliser la commande POST de la manière suivante :

POST http://yoursite.com/wp-json/wp/v2/posts/?status= "draft".

Ensuite, vous pouvez utiliser la commande PUT pour modifier l'état d'un projet particulier en saisissant son numéro d'identification :

PUT http://yoursite.com/wp-json/wp/v2/posts/983

Vous accéderez ainsi à votre message avec la possibilité de le modifier. Vous devez maintenant faire passer son statut de "brouillon" à "publier" :

"statut" = "publier"

En outre, vous pouvez y ajouter du contenu en utilisant l'argument "status" :

"status" = "publier" "content" = "contenu ici"

SUPPRIMER :

Une autre commande essentielle utilisée pour supprimer des messages, des pages, du contenu et des utilisateurs. Un message supprimé sera d'abord placé dans la corbeille.

Pour supprimer un message particulier, par exemple celui créé ci-dessus, saisissez quelque chose comme ceci :

DELETE http://yoursite.com/wp-json/wp/v2/posts/983

Si vous souhaitez supprimer définitivement le message sans l'envoyer à la poubelle, ajoutez ?force=true après le message :

DELETE http://yoursite.com/wp-json/wp/v2/posts/983?force=true

OPTIONS :

Si vous souhaitez vérifier les options de communication disponibles pour une ressource, vous pouvez utiliser cette commande. Lorsque vous entrez la commande, vous obtenez en sortie la liste des méthodes de communication disponibles pour une ressource particulière, ainsi que d'autres informations pertinentes, telles que les schémas d'authentification pris en charge, les en-têtes de requête et les types de contenu.

TÊTE :

Cette commande permet de récupérer les en-têtes du contenu sans avoir à s'occuper du contenu lui-même. De cette manière, un développeur peut obtenir les informations nécessaires sur des éléments de contenu, telles que les informations de mise en cache, le type de contenu et la longueur du contenu, sans avoir à les télécharger.

PATCH :

Cette commande vous permet de mettre à jour une partie particulière d'un contenu. Elle est quelque peu similaire à PUT, mais il n'est pas nécessaire de remplacer entièrement une ressource particulière. Vous pouvez ainsi mettre à jour le titre ou le contenu d'un article, ainsi que les métadonnées associées à un utilisateur, tout en conservant le reste.

Lorsque vous utilisez la commande, vous devez spécifier les modifications que vous souhaitez effectuer. Par exemple, pour modifier le titre, vous devez l'ajouter au corps de la requête :

"title" : "New Post Title" (Titre du nouveau message)

Conclusion

L'API WordPress REST est une interface multifonctionnelle qui permet à vos applications d'interagir avec votre site WordPress. L'interface est gérée à l'aide de différentes commandes, auxquelles nous avons consacré l'article d'aujourd'hui. Nous espérons que ces informations vous ont été utiles, merci pour votre temps !