Les APIs, ces trois lettres que l’on rencontre souvent sur le web, mais dont nous ne connaissons pas forcément la signification. Une API, pour “application programming interface”, permet à deux applications de communiquer entre elles. Dans cet article, nous allons explorer comment et pourquoi la notion d’API est de plus en plus populaire dans le monde du développement web.
API, un terme qui vous interroge ?
Une API permet de rendre les données ou les fonctionnalités d’une application disponibles pour être utilisées par d’autres applications. Cela devrait clarifier le concept d’interface de programmation applicative 😊
L’utilisation d’une API permet donc d’utiliser un programme existant plutôt que de le re-développer. C’est donc un gain de temps considérable.
Les possibilités concrètes d’une API
La première chose que fait une API, c’est qu’elle “expose” des fonctionnalités ou des données. Pour les utiliser, la plupart des APIs requièrent une clé (API key), voire parfois deux. Cette clé permet à l’API de vous identifier en tant qu’utilisateur ayant les droits nécessaires pour utiliser l’API.
L’authentification est un élément crucial lorsqu’il s’agit d’API. Prenons un exemple concret : à l’agence Debord, lorsque nous recevons un formulaire de contact, les données de ce contact sont envoyées à notre espace client grâce à une API. Nous avons conçu cet espace client avec une API pour permettre à d’autres applications, comme notre site web, d’y enregistrer des données. Que se passerait-il si cet enregistrement n’était pas soumis à des règles de sécurité ? Eh bien, n’importe qui pourrait enregistrer n’importe quoi dans notre espace client. Dans notre cas, chaque envoi de données via l’API de l’espace client nécessite une authentification. Ainsi, nous validons que les informations à enregistrer proviennent bien de notre site internet et pas d’autre source.
Exposer des données
L’une des principales fonctionnalités d’une API est l’exposition de données. Cela signifie que les contenus d’un site, comme les pages ou les articles, sont accessibles via des “endpoints” dans un format de données structurées. Concrètement, en se rendant à une certaine URL, vous obtiendrez les données d’un site au format JSON. De nombreux sites utilisent cette méthode de manière native, parfois sans que vous le sachiez.
À quoi cela ressemble-t-il ? Voici un exemple de l’API proposée par le site data.gouv.fr :
Si cela peut sembler intimidant pour les non-techniciens, cette page permet de récupérer les données inscrites, dans un format standardisé, et de les afficher n’importe où ailleurs.
Vous pouvez alors imaginer un site exposant des informations qui seront récupérées depuis un ou plusieurs sites.
Par exemple, Madame Durand possède 5 agences immobilières avec 5 sites internet différents. Elle peut alimenter chacun de ses 5 sites avec une seule API regroupant toutes ses annonces. Chaque site peut alors récupérer les annonces appropriées en fonction du code postal. Ainsi, Madame Durand n’a plus besoin de mettre à jour 5 sites, mais seulement son back-office d’annonces. Pratique, n’est-ce pas ?
Exposer des services
En plus d’exposer des données, une API peut également proposer des services ou des fonctionnalités. Par exemple, si vous souhaitez envoyer un grand nombre d’e-mails, au lieu de louer et configurer un serveur de messagerie, vous pouvez utiliser l’API d’un service comme Sendgrid. Concrètement, lorsque vous envoyez un formulaire sur votre site, un e-mail est envoyé en utilisant l’API de Sendgrid. Sendgrid vous offre des garanties sur la délivrabilité de votre e-mail ainsi que des statistiques sur sa réception. Cela vous permet d’avoir un service performant à un coût très faible, car Sendgrid offre même l’envoi de 40 000 e-mails gratuitement !
Autre exemple : lorsque vous avez un formulaire sur votre site avec un champ d’adresse. Parfois, lorsque vous tapez l’adresse ou le code postal, le formulaire vous suggère une adresse préformatée. Pour cela, vous pouvez utiliser l’API de Google Places.
Les différents types d’API
Une API peut être consultée par tous sans authentification, ce qu’on appelle une “API publique”. C’est notamment le cas des API géographiques du gouvernement français. Par exemple, l’API de geo.api.gouv.fr permet d’obtenir publiquement des informations sur les communes de France en consultant une URL :
curl 'https://geo.api.gouv.fr/communes?codePostal=78000'Mais une API peut également nécessiter une authentification, à l’aide d’une clé ou d’un jeton d’authentification (JSON Web Token). Dans ce cas, on parle d’ “API privée”.
Enfin, les API peuvent se différencier par leurs approches :
- Les API SOAP (Simple Object Access Protocol) : cette approche est de moins en moins utilisée.
- Les API REST (Representational State Transfer) : il s’agit de l’architecture la plus utilisée aujourd’hui.
- Les API GraphQL : ce nouveau style d’architecture d’API développé par Facebook propose une alternative à REST.
De nouvelles façons de concevoir une application
Utiliser une API permet de concevoir un site ou une application de manière plus moderne et moins monolithique. Cela permet d’améliorer les performances et offre de plus grandes possibilités d’évolution. À ce sujet, consultez notre article précédent sur la déconnexion des sites internet, qui contient de nombreuses informations à ce sujet.
De nouvelles opportunités commerciales
La généralisation des APIs représente également de nouvelles opportunités. Aujourd’hui, des entreprises sont créées avec une offre consistant à mettre à disposition une API. Les clients paient un abonnement pour accéder à cette API et l’utiliser. Dans votre propre secteur, vous pouvez penser à une API qui expose des données ou des fonctionnalités pouvant être réutilisées par les entreprises de votre domaine. Vos concurrents d’aujourd’hui pourraient devenir vos clients de demain 😎
Toutes les données et fonctionnalités peuvent potentiellement être transformées en une API, il vous suffit de les imaginer !
