Qu'est-ce qu'une API ? [Lecture rapide]

Si vous n'êtes pas développeur, mais que vous travaillez dans la technologie, le terme API est probablement quelque chose que vous comprenez dans un sens conversationnel. Vous savez probablement ce que cela signifie (interface de programmation d'application), et peut-être que vos équipes utilisent des API pour faire leur travail, ou peut-être même le produit lui-même (Twilio SendGrid, par exemple).

Mais qu'est-ce qu'une API exactement et comment fonctionnent-elles ?

Comprendre les principes plus profonds derrière les API vous aidera à mieux commercialiser, vendre ou utiliser ces technologies vous-même.

Cet article explique comment fonctionnent les API, comment les développeurs les construisent et comment les utiliser (avec des exemples concrets).

Comment fonctionnent les API ?

La façon dont les navigateurs Web interagissent avec les serveurs est un principe fondamental des API. Le Web est un ensemble de serveurs distants dispersés sur toute la planète. Lorsque vous ouvrez un navigateur et saisissez un site Web, le navigateur appelle le serveur du client (quel que soit l'application ou le serveur sur lequel un site Web est hébergé) pour récupérer et afficher tout ce qui se trouve sur cette URL.

Bien qu'une API ne soit pas le serveur lui-même, c'est la partie du serveur, connue sous le nom de point de terminaison, qui envoie et reçoit certaines réponses. Les API sont un moyen pour différents logiciels de communiquer (c'est-à-dire d'envoyer et de recevoir) les uns avec les autres en ouvrant des points de terminaison.

Les développeurs configurent des appels d'API pour récupérer des données spécifiques nécessaires à diverses fins lorsqu'ils créent des applications ou des sites Web. Par exemple:

• Vous venez d'ouvrir votre application Instagram ? Cela a été rendu possible par un appel API.
• Avez-vous déjà ajouté un événement à votre agenda Google à partir d'un autre site Web ou d'un e-mail ? Ce site utilisait l'API Google Calendar pour récupérer ces informations spécifiques sur le serveur Google Calendar.

À retenir : les développeurs configurent des appels d'API pour récupérer des types de données spécifiques afin d'afficher ce dont ils ont besoin lorsqu'un utilisateur se trouve sur un site Web ou exécute une application.

La montée du REST

Un autre terme que vous avez probablement entendu est API REST. Ce n'est pas différent en soi de la définition traditionnelle d'une API. Il est néanmoins utile de comprendre pourquoi les API REST sont devenues si populaires et ce qui les distingue des autres.

Au début, les API ont été conçues pour répondre aux exigences de SOAP (Simple Object Access Protocol). Mais cette méthode était un peu fastidieuse et nécessitait beaucoup de bande passante pour transférer les ensembles de données. Cela a également demandé beaucoup d'énergie aux développeurs (comme pas le genre amusant). SOAP utilise le langage de balisage XML notoirement lourd pour afficher les données. Utile pour assurer la compatibilité universelle, mais c'est à peu près tout.

Les développeurs recherchaient des moyens plus légers et plus flexibles pour effectuer des appels d'API. Les API REST (Representational State Transfer) offrent une solution alternative à l'API SOAP. Ils ne sont pas contraints par un protocole spécifique, bien qu'ils doivent respecter certains styles architecturaux (si vous êtes intéressé à plonger là-dedans, rendez-vous ici).

Au lieu d'être affiché avec le balisage XML, le serveur utilise à la place le langage JSON léger (uniquement des fichiers texte). Les API REST ont une bande passante beaucoup plus légère que SOAP (il ne s'agit généralement que d'une URL) et elles sont naturellement optimisées pour la communication sur le Web.

À retenir : considérez les API REST comme la Marie Kondo des données. Ils prennent et n'utilisent que *précisément* ce dont ils ont besoin. Les API SOAP sont comme le garage de votre voisin qui est actuellement rempli à ras bord de papier toilette.

Comprendre les différents types d'API

Quels que soient le protocole ou les styles suivis par une API, il existe plusieurs types d'API, notamment :

• API ouvertes - Également appelées API publiques, ces points de terminaison sont accessibles par n'importe quel développeur et n'imposent généralement aucune restriction à l'utilisateur. Ils acceptent généralement les dons.
• API partenaires - Il s'agit d'API conçues pour être utilisées ensemble et qui ne sont généralement accessibles que par une sorte de marché.
• API internes – Il s'agit d'outils internes que les entreprises utilisent pour aider leurs employés à être plus efficaces ou fournir aux employés un moyen plus sûr de partager des données/informations.
• API composites - Les API composites sont un moyen de consolider les appels d'API qui sont liés mais qui nécessiteraient normalement des appels d'API individuels.

Exemples concrets d'API

Il existe de nombreuses API dans la nature (certaines comptent plus de 15 000) qui aident les utilisateurs à accéder à diverses applications. Vous trouverez ci-dessous quelques exemples notables qui vous aideront à comprendre la portée de l'écosystème d'API.

Le cocktail DB

Supposons que vous possédiez un magasin d'alcools local et que vous souhaitiez proposer des recettes de cocktails sur votre site Web. Vous pouvez envisager d'utiliser l'API Cocktail DB ci-dessus. Toutes ces données (les recettes de cocktails) existent déjà sur le serveur de quelqu'un d'autre et peuvent être évaluées via l'API.

Lorsqu'un utilisateur clique sur les recettes de margarita (sans doute le cocktail supérieur), leurs serveurs trouvent que cette recette spécifique l'envoie en JSON, elle est récupérée sur le site Web et analysée en HTML et CSS pour être présentable sur le navigateur de votre site Web.

OpenWeatherMap

L'ajout d'une section météo à votre site Web est un cas d'utilisation très courant. Pensez à n'importe quelle station de ski, magasin de vélo ou agence de voyage. L'API OpenWeatherMap stocke toutes les prévisions et informations météorologiques et affiche uniquement la partie que vous demandez.

Cette API fournit des versions gratuites et premium en fonction de la quantité de données que vous souhaitez afficher.

API de messagerie SendGrid

L'API SendGrid Email exploite SMTP (protocole de transfert de courrier simple) pour permettre aux clients d'envoyer de grandes quantités d'e-mails transactionnels et déclenchés, comme les réinitialisations de mot de passe, la confirmation de compte et les notifications d'expédition.

Twillio SMS

L'API SMS Twilio est une autre API REST qui permet d'ajouter des fonctionnalités de messagerie aux applications. La messagerie SMS est devenue de plus en plus populaire comme moyen pour les marques de communiquer avec les clients car elle est personnelle, en temps réel, et ces messages sont lus à des taux beaucoup plus élevés.

Comment utiliser une API

Avant que vous ou votre équipe ne commenciez à utiliser les API, il est important de savoir si elles sont ouvertes, utilisées conjointement avec un service partenaire ou composites.

Comment démarrer avec une API

Lisez la documentation. Toute API doit avoir une documentation applicable à suivre. Il vous indiquera quelles dépendances vous avez, de quel type d'API il s'agit et comment l'utiliser. Une mauvaise documentation devrait être un signal d'alarme pour vous et votre développeur. Nous sommes assez fiers de la superbe documentation de Twilio et SendGrid.

Générez une clé API. Vous devrez générer une clé API pour commencer à l'utiliser. Voici les instructions de l'API Google Maps :

Remarque : Ne partagez jamais les clés API et assurez-vous qu'elles ne sont visibles sur aucun code public que vous mettez sur GitHub.

Commencez à créer : envoyez des e-mails gratuitement avec l'API SendGrid Email

Le reste dépend de toi! Les opportunités sont vraiment infinies lorsque vous travaillez avec des API. Pour un aperçu de toutes les opportunités de travailler avec l'API Twilio, consultez Twilio Code Exchange.

Si vous souhaitez utiliser l'API SendGrid Email pour envoyer des e-mails gratuits, consultez-le ici.