L'API WordPress JSON Rest (WP API) : qu'est-ce que c'est, comment ça marche et ce que cela signifie pour l'avenir de WordPress

Publié: 2015-04-28

Il est indéniable que WordPress possède une communauté de développeurs absolument massive, mais il n'en reste pas moins que la grande majorité des utilisateurs de WordPress ne sont pas des développeurs. Cela signifie que même si les développeurs, ceux qui construisent WordPress lui-même ainsi que les thèmes WordPress, les plugins et plus sont bien mieux équipés pour comprendre l'évolution de WordPress et comment son avancement continu affectera l'ensemble de l'écosphère WordPress à l'avenir.

J'aime penser que l'un des principaux objectifs d'un blog comme celui-ci est d'aider à combler le « fossé de compréhension » qui existe entre des groupes comme les développeurs, les utilisateurs expérimentés et les utilisateurs réguliers, au moins en termes de principes généraux, d'idées, et nouveautés. Un bon exemple est la nouvelle API WordPress JSON REST et ce que son ajout au noyau signifie pour tout le monde, peu importe où ils se situent dans le spectre technique des utilisateurs de WordPress.

Au cours de la dernière année environ, il y a eu beaucoup de buzz à propos de ce nouvel ajout à WordPress et les développeurs, dans l'ensemble, semblent assez enthousiastes à ce sujet. Je crois pour une bonne raison, mais ce que je ne veux pas, c'est que tout le monde soit exclu du plaisir. Ou, d'ailleurs, le remue-méninges sur la meilleure façon de l'utiliser.

C'est pourquoi dans cet article, j'aimerais vous présenter les idées de base derrière la technologie de l'API WordPress JSON REST et décrire ce que certains développeurs en font déjà. J'expliquerai également ce qu'il est possible d'utiliser d'autre et j'espère inspirer certains d'entre vous à l'utiliser de manière encore plus intéressante et inexplorée.

Pour commencer, clarifions quelques termes clés.

Qu'est-ce qu'une API ?

Une API ou Application Programming Interface est un intermédiaire logiciel qui permet aux programmes d'interagir les uns avec les autres et de partager des données de manière limitée et clairement définie.

Voici quelques bons exemples d'API en action :

1. Chaque fois qu'une application utilise Google Maps pour afficher ses informations de localisation.

2. Un client Twitter mobile ou de bureau.

3. Un jeu/service qui intègre des fonctionnalités Facebook telles que la connexion, la messagerie, etc.

Dans ces cas, et dans tous les autres comme eux, les API « exposent » certaines fonctions internes des applications principales afin que les développeurs externes puissent les utiliser dans leurs propres applications ou sites Web. Dans ces exemples, les développeurs d'applications ont eu la possibilité d'exploiter les fonctionnalités puissantes (et/ou le contenu) des principaux services Web afin de pouvoir s'appuyer sur eux et/ou d'intégrer du contenu et des fonctionnalités clés dans leurs propres produits. Mais encore une fois, seulement de manière limitée et clairement définie. Cela permet à une forme de collaboration ouverte d'aller de pair avec la sécurité.

Qu'est-ce qu'une API REST ?

REST signifie REpresentational State Transfer. C'est un style architectural de construction d'API ; pas un langage de code ou une description de sa fonction. Une API REST est conçue pour fournir une forme légère de communication (moins de bande passante) entre le producteur (ex : Twitter) et le consommateur (ex : client Twitter), ce qui en fait une excellente solution pour les services Web à volume élevé comme Google Apps, Facebook, Twitter, et maintenant WordPress.

Qu'est-ce que l'API WordPress JSON REST (API WP) et comment ça marche ?

JSON, qui signifie JavaScript Object Notation, est un format d'échange de données léger basé sur un sous-ensemble du langage de code JavaScript. Il est facile à lire et à écrire pour les humains et facile à analyser et à générer pour les machines. Ce qui en fait également un excellent choix pour la création d'API REST, telles que la nouvelle API WordPress JSON REST ou l'API WP, comme elle a été nommée.

JSON est la notation, REST est le style architectural et API est l'interface qu'ils constituent. Lorsque vous les mettez tous ensemble, vous obtenez un outil que les développeurs peuvent utiliser pour partager facilement des données de leurs sites Web WordPress vers d'autres sites Web ou applications.

Plus précisément, l'API WP vous permet d'effectuer des actions CRUD sur le contenu WordPress. Ce qui signifie créer, lire, mettre à jour et supprimer les types de contenu suivants :

  • Des postes
  • Pages
  • Types de publication personnalisés
  • Médias
  • commentaires
  • Taxonomies
  • Utilisateurs
  • Ou tout autre type de contenu pour lequel vous pouvez l'étendre…

Pour avoir une meilleure idée de la raison pour laquelle quelqu'un pourrait vouloir faire cela en premier lieu, il est utile d'examiner certains cas d'utilisation qui montrent les avantages de ces capacités.

Comment l'API WP a-t-elle déjà été utilisée ?

Avec la partie principale de l'API WP et disponible pour tous les utilisateurs de WordPress, la valeur associée à son utilisation de manière innovante a augmenté de manière exponentielle. Jusqu'à présent, d'après ce que j'ai personnellement vu et lu, certains cas d'utilisation évidents semblent dominer en ce moment.

Par exemple, vous pouvez utiliser l'API WP pour améliorer à peu près toutes les fonctionnalités WordPress existantes basées sur JavaScript, telles que :

  • Thèmes ou plugins backbone.js
  • peupler des parchemins infinis
  • validation/soumission du formulaire
  • édition de contenu frontal

Vous pouvez également:

  • afficher le contenu d'un autre site au sein d'un réseau multisite
  • afficher le contenu d'un site WordPress séparé
  • créer ou mettre à jour du contenu sur un site WordPress séparé ou un autre site au sein d'un réseau multisite

Ce sont tous des cas d'utilisation extrêmement précieux qui résolvent à la fois les problèmes existants et ajoutent de nouvelles possibilités créatives. Cependant, ce que je suis le plus impatient de voir se produire à l'avenir, ce sont certains des cas d'utilisation potentiels ci-dessous.

Quels sont les autres cas d'utilisation potentiels de l'API WP ?

Pour moi, l'un des aspects les plus intéressants de l'API WP est qu'elle vous permet de libérer complètement votre contenu de WordPress. Donner aux utilisateurs de WordPress un contrôle sans précédent sur la façon dont leur contenu est vécu.

Il existe plusieurs façons de procéder :

Afficher et gérer votre contenu dans une application mobile/de bureau (ce n'est pas l'application WordPress officielle).

Pour moi, celui-ci est énorme. Il ouvre une tonne de possibilités pour les créateurs de contenu et les consommateurs. Les créateurs de contenu pourraient commencer à voir une nouvelle et meilleure récolte de clients de blogs mobiles/de bureau qui leur permettent de créer des articles de blog et plus encore dans des environnements uniques qui ne pourraient jamais être construits dans le backend de WordPress lui-même. De même, il pourrait y avoir de toutes nouvelles expériences de contenu construites sur le Web ou des applications mobiles en utilisant des programmes qui fonctionnent complètement différemment de WordPress mais qui tirent leur contenu d'un site WordPress.

Intégration de votre contenu avec d'autres plateformes d'applications.

Il peut y avoir des plates-formes d'applications qui ne sont pas construites sur PHP ou tout autre langage de code utilisé dans WordPress qui sont néanmoins capables d'interagir de manière transparente avec votre contenu. Je pouvais voir une sorte d'outil d'agrégation qui permet aux gens de connecter rapidement et facilement leur blog et d'ajouter du contenu via des balises ou des catégories. Ou quelque chose de complètement différent ! Littéralement, la seule limite est de savoir comment vous pouvez penser à manipuler de manière créative les actions CRUD de grande envergure dont nous avons parlé ci-dessus.

Intégration d'autres plateformes d'applications à votre site WordPress.

Celui-ci est fondamentalement l'inverse du dernier cas d'utilisation. Il est néanmoins important de le signaler par lui-même. Cela pourrait vous permettre d'avoir un très large éventail de sources de contenu, toutes alimentant un seul site WordPress, puis affichées comme vous le souhaitez.

Que signifie l'API WP pour l'avenir de WordPress ?

En un mot, ce que l'API WP signifie pour l'avenir de WordPress, c'est qu'il s'agit d'un pas de plus vers devenir une plate-forme d'applications à part entière. La manière dont nous l'utiliserons sera l'un des nombreux facteurs déterminants de la rapidité et de la manière dont cela deviendra réalité. Personnellement, cependant, je ne m'inquiète pas de savoir si WordPress est classé comme une chose ou une autre, je suis juste enthousiasmé par les nouvelles possibilités.

Par exemple, j'aimerais que certains de mes programmes d'écriture, de montage vidéo et de graphisme préférés puissent être publiés directement dans WordPress. Je peux imaginer une douzaine de choses incroyables que vous pourriez faire - de la thématique à la narration en passant par la publication d'articles "simples" - que cette nouvelle API rend possible. Il ne nous reste plus qu'à travailler ensemble en tant que communauté pour tout construire !

Ressources API WP recommandées

Si vous souhaitez en savoir plus sur l'API WP et sur ce que vous pourriez en faire, je vous recommande de consulter les ressources suivantes :

  • Site officiel de documentation de l'API WP
  • Rachel Baker : Mettez votre contenu au repos avec WP-API

  • Introduction à l'API JSON REST (Série)
  • Un guide du débutant sur HTTP et REST

  • Apprendre le REPOS

En conclusion

WordPress, comme toujours, grandit et évolue pour continuer à répondre aux demandes de sa communauté. L'ajout de l'API WP au noyau est l'une des façons les plus importantes et les plus excitantes de l'avoir fait depuis un certain temps. Je sais que je suis personnellement très excité de voir ce que les autres décident d'en faire et j'adorerais trouver des groupes avec lesquels collaborer sur mes propres idées. Et vous cependant ? Êtes-vous enthousiasmé par l'API WP ? Avez-vous au moins l'impression de le comprendre maintenant? Veuillez prendre une minute ou deux pour partager vos réflexions avec l'ensemble de la communauté dans la section commentaires ci-dessous.

Vignette de l'article via Imagentle // shutterstock.com