Comment fonctionne lAPI ? Comment intégrer lAPI dans lapplication

L'interface de programmation d'applications (API) est l'une des dernières nécessités pour créer des applications intelligentes. C'est un canal de communication entre deux applications. Que ce soit consciemment ou non, vous avez utilisé des API à un moment donné en naviguant sur Internet ou en utilisant des programmes dans votre vie quotidienne.

Les API envoient souvent des données complexes sous forme de réponses, alors comment pouvez-vous comprendre et utiliser ces informations pour servir vos utilisateurs ? Les API facilitent la vie des développeurs expérimentés comme de ceux qui débutent. Vous devez donc savoir comment les utiliser avec votre application.

Avec quelques cas d'utilisation et exemples, voyons comment vous pouvez utiliser les API pour servir vos programmes en tant que développeur.

Qu’est-ce que l’API ?

Les API permettent à des programmes distincts d'interagir les uns avec les autres

Les API permettent à des programmes distincts d'interagir les uns avec les autres. Les API définissent les requêtes qui peuvent être effectuées, la manière dont les requêtes sont effectuées et permettent l'échange de données entre différentes applications logicielles.

Les API sont de 3 types : publiques, privées et partenaires. Les API publiques (ou API ouvertes) sont accessibles publiquement à tout développeur. L’utilisation d’API publiques comporte certaines limites et elles peuvent être gratuites ou commerciales. Les API privées sont utilisées exclusivement au sein d'une entreprise ou d'une organisation. Les API partenaires ne sont disponibles que pour des partenaires commerciaux spécifiques, le plus souvent utilisées pour faciliter l'intégration logicielle entre deux entreprises différentes.

Comment fonctionne l'API ?

Les développeurs créent des API en tant que produits pouvant servir à d'autres développeurs. L'objectif est de rendre les processus de développement Web complexes plus faciles, plus efficaces et plus rapides pour les développeurs grand public ou les entreprises.

La plupart des entreprises dépendent désormais d'API tierces pour résoudre les problèmes et mieux servir leurs clients. Cependant, utiliser l’API n’est pas aussi compliqué que beaucoup de gens le pensent. Vous pouvez le considérer comme une solution tierce, qui vous donne une réponse spécifique sous forme de données, lorsque vous effectuez une requête HTTP spécifique.

Utiliser l’API, c’est comme commander dans une pizzeria. Vous ne pouvez pas aller dans la cuisine pour leur dire ce que vous voulez. Vous avez besoin d'un serveur pour prendre votre commande et la livrer à la cuisine, puis revenir avec la pizza de votre choix.

Vous pouvez considérer une API comme le lien entre vous et la cuisine. Dans ce cas, vous êtes un client visitant un restaurant qui met à disposition des serveurs (API). Le serveur répondra alors avec votre sélection de pizza (données). Dans une véritable API, l'application Web est le client qui demande à consommer le contenu du fournisseur via l'API, en effectuant des requêtes de point de terminaison HTTP.

Comment l’API est-elle utilisée ?

Les API sont utilisées dans de nombreux cas

Les API sont utilisées dans de nombreux scénarios, notamment dans des catégories telles que les API de base de données, les API distantes et les API Web. Vous interagissez probablement avec les API Web plusieurs fois par jour lorsque vous naviguez sur votre smartphone ou votre ordinateur. Les API Web échangent des requêtes et des données à l'aide du protocole HTTP.

Les sites de réservation de voyages, tels que Skyscanner et Booking.com, utilisent des API Web pour regrouper les données de vol et de destination pour les clients. La commodité des API Web permet de confirmer la disponibilité des chambres d'hôtel et la durée de votre séjour en temps réel en échangeant instantanément vos demandes et données depuis l'hôtel.

Qu'est-ce que le point de terminaison de l'API ?

La connexion à une API nécessite que vous connectiez votre programme à un point de terminaison d'API. Vous pouvez considérer cela comme une connexion bidirectionnelle. Le point de terminaison connecté à votre programme envoie la requête, tandis que le point de terminaison connecté à l'API vous renvoie une réponse spécifique.

Un point de terminaison est une URL de requête et fournit au client un accès direct aux ressources d'une API.

En plus de récupérer des données à l'aide de l'API, vous pouvez également POST des requêtes du fournisseur au client, utiliser la méthode PUT pour obtenir plus d'informations du fournisseur, ainsi qu'utiliser la méthode DELETE pour supprimer les données existantes de votre programme. Chacune de ces méthodes est généralement disponible dans la documentation de l'API.

Critères de connexion à l'API

L'intégration d'une API à votre programme n'est pas seulement une décision spontanée : c'est préméditée. Vous devez connaître les informations et la quantité souhaitées. Cela permet de réduire la complexité, surtout si vous traitez des données JSON sous forme de tableau multidimensionnel. Il vous permet également d'obtenir les informations spécifiques dont vous avez besoin pour votre programme.

Il existe des centaines d’API avec différentes règles pour s’y connecter. Si certaines API sont gratuites et open source, d’autres ne sont accessibles que sur abonnement.

Bien que certaines API soient transparentes et simples, ne nécessitant aucune condition préalable, d'autres API peuvent exiger que vous remplissiez des conditions telles que la génération d'une clé API ou l'enregistrement d'un compte de développeur avant de pouvoir vous connecter au point de terminaison.

Cependant, l’un des aspects les plus importants de toute API est sa documentation. Il est préférable de lire et de suivre la documentation de toute API à laquelle vous envisagez de vous connecter pour obtenir des instructions sur la façon de coder et d'utiliser ses ressources. En effet, chaque API possède ses propres méthodes et instructions de connexion.

Pour vous connecter à n’importe quelle API, vous devez également connaître les langages de programmation qu’elle prend en charge.

Comment se connecter à une API : Exemple pratique

Il n'existe pas de moyen spécifique de se connecter à l'API, mais quelques exemples vous montreront les bases de la façon dont vous pouvez utiliser les données de l'API avec votre application.

Examinons quelques brefs exemples de code sur la façon dont vous pouvez vous connecter à une API.

Comment utiliser l'API du sélecteur de couleurs Iro.Js

Iro.js est une API simple qui vous permet d'ajouter un sélecteur de couleurs gratuit à votre site Web. Lorsque vous sélectionnez un point sur la roue chromatique, l'API renvoie le code hexadécimal ou RVB de cette couleur. Pour vous connecter à l'API iro.js, il vous suffit de coller son point de terminaison CDN (Content Delivery Network) au début du DOM.

La documentation complète de cette API est disponible sur iro.js.org :

https://iro.js.org/guide.html

Voyons comment vous pouvez vous connecter à cette API avec l'exemple de code ci-dessous :

Display color picker

Dans le cas de l'exemple d'API ci-dessus, vous n'avez pas besoin d'une clé API pour vous y connecter. Cependant, pour mieux comprendre, examinons de plus près JavaScript. Pour vous connecter à cette API, appelez simplement la fonction ColorPicker depuis la classe iro , puis transmettez l'identifiant du conteneur de roue chromatique à la classe.

Le point de terminaison de l'API iro.js est facile à connecter, car ses développeurs ont effectué le travail supplémentaire de codage de la couche pour les utilisateurs. L'image ci-dessous est le résultat de l'exemple de code ci-dessus.

Résultat de l'exemple de code

Pour voir comment l'événement de changement de couleur se produit, vous pouvez ouvrir un autre fichier HTML et coller le code suivant dans sa section scripts :

var colorPicker = new iro.ColorPicker('#color-pick', {
   // Set the size of the color picker
   width: 400,
   // Set the initial color to pure red
   color:"#ff0000"
 });
const myColor =(color)=>{
	console.log(color.hexString);
};
colorPicker.on("color:change", myColor);

Le code ci-dessus enregistre les valeurs de couleur hexadécimales chaque fois que vous modifiez la position du sélecteur de couleur sur la roue.

Comment utiliser l'API d'échange de devises NoCodeAPI

NoCodeAPI fournit de nombreuses API, notamment l'API de conversion de devises. Pour vous connecter à ce point de terminaison de change, visitez NoCodeAPI et créez un compte :

https://app.nocodeapi.com/login

Lorsque vous vous connectez, il y a une barre de recherche en haut de la page. Dans cette barre de recherche, tapez change de devise , lorsque votre requête apparaît, cliquez sur Activer.

Sur la page suivante, cliquez sur Créer une API d'échange de devises . Ensuite, entrez un nom pour l'API et cliquez sur Créer.

Une fois que vous avez créé l'API, cliquez sur Afficher la documentation. Ensuite, sélectionnez votre langue préférée pour afficher le code de connexion au point de terminaison de l'API. Vous pouvez ensuite copier cet exemple de code et le coller dans votre application pour une personnalisation plus poussée.

Voir l'exemple de code ci-dessous pour la conversion de devise :