Qu'est-ce qu'une API ?

Si vous travaillez avec la technologie depuis un certain temps, vous avez probablement rencontré le terme API. Pour ceux qui ont programmé et compris comment créer un site Web à partir de zéro, vous serez très familier avec le terme API.

Une API est derrière de nombreuses fonctions populaires que vous utilisez sur les sites Web. C'est un acronyme qui signifie Application Programming Interface. Une bonne illustration serait de penser à une recette pour faire différents types d'aliments. Chaque recette contient des instructions étape par étape sur la façon de créer le plat. Il s'agit du code impliqué dans l'API. Un ordinateur doit suivre un ensemble d'instructions pour accomplir une tâche.

Vous pouvez prendre cette recette et la donner à n'importe quel chef. Ils seront en mesure d'interpréter les ingrédients et de comprendre comment combiner tous les différents éléments dans le produit fini. Vous avez même le choix de suivre vous-même les instructions pour assembler la recette si vous comprenez la cuisine et avez suffisamment de formation pour utiliser tous les outils de la cuisine. Une API, en fin de compte, n'est qu'une recette que l'ordinateur sait suivre.

Développeurs et API

Poursuivant notre illustration du fonctionnement d'une API, certains apporteront la recette à un chef professionnel qui peut rapidement préparer la nourriture et vous donner le plat que vous commandez. Un développeur est comme une personne qui peut déjà créer la recette et la modifier.

Une API est une série d'instructions destinées à l'ordinateur. Pour un développeur ayant une expérience de codage, il peut ajuster certains aspects de l'API et le modifier pour répondre à ses besoins. Ce sera au-delà de la portée de beaucoup qui veulent simplement brancher l'API sur leur site.

L'utilisation d'une API est bonne pour les utilisateurs quotidiens car elle leur permet d'obtenir plus de fonctionnalités de leur site Web sans créer le code par eux-mêmes. Vous souhaitez peut-être afficher la météo et l'heure pour un utilisateur qui visite votre site Web. Ce contenu est dynamique et non statique. Vous ne pouvez pas simplement poser la météo pour une journée et la laisser tomber. La valeur change constamment, vous devez donc accéder à une API pour que les informations soient mises à jour.

API et WordPress

Si vous utilisez WordPress et cherchez un moyen d'intégrer une API, nous vous recommandons de le faire via un plugin ou un thème WordPress. De nombreux plugins gratuits et premium peuvent vous aider à intégrer les API assez facilement. Cependant, la plupart d'entre eux sont très limités, sauf si vous payez.

Si vous avez vous-même des connaissances en codage, il est simple d'intégrer une API externe sur votre site WordPress. Pour cela, nous vous recommandons ce guide de Rapidapi qui explique comment intégrer des API externes.

Contenu dynamique

Chaque fois que vous avez affaire à du contenu dynamique, votre première pensée devrait être de trouver une API capable d'alimenter votre site Web en informations en évolution rapide. Il peut également vous permettre d'interagir avec des programmes populaires à un niveau plus profond.

Prenez, par exemple, Twitter. Il s'agit d'une plate-forme populaire pour les personnes intéressées par les médias sociaux. Si vous faites partie du marketing numérique, vous voudrez accéder aux choses à un niveau plus profond. À l'aide de l'API Twitter, vous pouvez rapidement extraire des informations dans des feuilles de calcul pour les décomposer et déterminer des éléments tels que les intérêts des utilisateurs et le nombre de connexions dont ils disposent. Si vous êtes un spécialiste du marketing numérique, vous souhaiterez identifier rapidement les personnes de certains groupes démographiques afin de savoir quels produits leur proposer. L'API Twitter vous permet de faire ces choses car vous pouvez extraire de grandes quantités d'informations en une seule fois au lieu de tout compiler à la main.

Améliorer votre site

Nous avons brièvement examiné comment vous pouvez améliorer votre entreprise en utilisant une API pour une grande entreprise. Que pouvons-nous tirer d'autre des sites Web externes ? En plus de charger la météo pour un utilisateur qui change dynamiquement, nous pouvons afficher quelque chose d'un peu plus intéressant.

Aimeriez-vous un site Web capable d'afficher les dernières images de Flickr ou même de Facebook ? Ce serait un excellent contenu pour vos utilisateurs qui les intéresseraient. Pour cela, localisez d'abord la documentation de l'API pour Flickr. Il est important de passer par là en premier si vous rencontrez des problèmes avec l'intégration de l'API dans votre site.

Vous verrez maintenant la possibilité de demander le format que vous souhaitez. Pour de nombreuses API, vous aurez le choix entre REST, XML-RPC et SOAP. Dans ce cas, choisissez REST, qui est très populaire auprès des sites WordPress. Lorsque vous cliquez dessus, un point de terminaison de l'API Flickr REST vous sera présenté.

Qu'est-ce que le REPOS ?

REST est un autre acronyme à apprendre si vous souhaitez avoir un contenu dynamique et en constante évolution sur votre site. Avec REST, nous pouvons ensuite utiliser GET, POST et DELETE. Ceci est pour toutes les données sur Flickr, mais cela fonctionne également pour Facebook, Google ou Instagram.

L'acronyme signifie Representational State Transfer. Il a été créé pour distribuer l'hypermédia et a fait son apparition avec Roy Fielding en 2000. Vous pouvez maintenant avoir des requêtes HTTP qui obtiendront des données pour vous. Les requêtes HTTP peuvent également publier des données sur d'autres sites Web. L'API est le langage que parlent deux programmes informatiques lorsqu'ils se parlent et communiquent. En comprenant ce langage et son fonctionnement, vous pouvez extraire des données de presque tous les sites.

Clés API

Les sites Web ne simplifieront pas l'extraction des données à afficher sur votre site WordPress. Vous devez d'abord créer un compte. Une fois que vous avez votre compte sur le site Web, demandez-leur une clé API. Assurez-vous de lire les conditions d'utilisation. Il existe des termes spécifiques qui seront différents selon le site Web avec lequel vous travaillez. Certains sites limitent le nombre de requêtes HTTP GET que vous pouvez effectuer pendant un certain laps de temps.

Peut-être êtes-vous limité à seulement 50 requêtes GET pour un jour donné. Cela garantit que les serveurs ne sont pas constamment martelés par des personnes cherchant à faire des demandes sur les ressources. Vous pouvez augmenter les limites comme celles-ci plusieurs fois en optant pour une version Pro ou une version commerciale. Lors de la mise à niveau, vous aurez accès à davantage de requêtes HTTP que vous utiliserez pour appeler les serveurs. Cela sera généralement utilisé par une entreprise qui doit passer de nombreux appels et ne s'appliquerait pas à un utilisateur régulier qui essaie simplement d'afficher de nouvelles informations sur son site.

Demander une autorisation

Vous ne pourrez pas toujours obtenir l'autorisation d'avoir une clé API. Certains sites exigent que vous fassiez une demande et que vous expliquiez la raison pour laquelle vous souhaitez accéder à la clé. Les entreprises ne veulent pas qu'une charge énorme soit placée sur leurs ressources à moins que le développeur n'utilise activement les appels pour aider à promouvoir leurs propres produits et services. Ils peuvent même demander à une équipe d'examiner votre demande. Si vous souhaitez vous familiariser avec la technologie, demandez l'accès à partir d'un site Flickr où les exigences sont faibles. Maintenant, vous aurez votre clé ainsi que le code avec elle.

Authentification et API

Déterminez ensuite si vous souhaitez utiliser l'API pour obtenir des données nécessitant une authentification. Par exemple, si vous deviez utiliser une API Facebook ou Instagram qui vous donne la possibilité de publier des images et du texte, cela devrait être authentifié. Pourquoi est-ce? Eh bien, si vous y réfléchissez de cette façon, vous auriez besoin d'un compte pour publier sur Facebook normalement. Vous ne pouvez pas publier de manière anonyme sur le site. De même, si une API publie en votre nom, vous devez également être authentifié avec un nom d'utilisateur et un mot de passe pour entrer. Cela vous identifiera et le contenu publié vous renverra si des éléments sont publiés qui ne devraient pas l'être.

De nombreux systèmes utiliseront OAuth pour l'authentification, car le protocole est facile à utiliser et offre aux utilisateurs un moyen simple de faire interagir l'API avec un site Web en tant que proxy. Les informations sont envoyées via un lien sécurisé afin que l'identité de l'utilisateur ne soit pas révélée. Cependant, vous n'avez pas toujours besoin d'être authentifié.

Mettre tous ensemble

Nous avons maintenant toutes les pièces dont nous avons besoin pour commencer à faire des appels d'API. Dans WordPress, accédez à Apparence puis Widgets. Ceux-ci sont écrits en PHP. À l'aide de la documentation de l'API que vous avez extraite du site Web, collez-la pour commencer à faire des demandes. Dans le cas de l'utilisation de l'API Flickr, l'URL ressemblerait à https://flickr.com/services/rest

Dans le code, si vous voyez une ligne pour votre clé API, copiez-la à partir du moment où vous l'avez demandée et avez reçu votre mot de passe et votre clé. Lorsque vous récupérez les données d'un site, elles peuvent être au format HTML, XML, Texte ou JSON. Supposons que vous n'êtes pas complètement familiarisé avec tous ces formats ; c'est bon. Sélectionnez-en un avec lequel vous pourrez travailler et que vous pourrez interpréter plus tard.

Regarder les données

Une fois que vous avez fini de coller les informations nécessaires pour obtenir les données, vous aurez également besoin d'un fichier PHP ou d'un fichier WordPress pour lire les données et afficher les informations à l'écran. Encore une fois, revenez à la documentation de l'API sur le site de l'entreprise avec laquelle vous travaillez. Il devrait y avoir un bloc de code qui produira les données dans un format que vous pouvez lire sous forme de texte ou afficher sous forme d'images sur votre site WordPress.

Formatage des données

Une fois que vous voyez que les données s'affichent sur votre site, cela peut sembler étrange. Le formatage n'est que le flux de données brutes. Lorsque vous effectuez un appel d'API vers un site externe, il n'y a aucune tentative de le formater d'une manière qui semblera agréable. Si vous souhaitez façonner les données de manière à ce qu'elles aient l'air présentables, vous pouvez utiliser un fichier CSS destiné à tout peaufiner. Si vous avez du mal à écrire le CSS, vous pouvez trouver des exemples en ligne pour vous guider. Copiez le code dans votre fichier CSS pour que votre site WordPress puisse y accéder.

Conclusion

Il s'agissait d'un bref tutoriel sur la façon d'intégrer une API à votre site WordPress. Le sujet est complexe et peut être difficile même lors de la copie de code. Enregistrez-vous auprès de certains sites en ligne si vous rencontrez des problèmes et n'oubliez pas de revenir sur Superb Themes pour plus de critiques et de didacticiels.