Qu’est-ce qu’une interface de programmation d’application (API) ?
Une interface de programmation d’application, ou API, est un ensemble de définitions, de règles et de protocoles permettant la communication entre deux entités : les utilisateurs (personnes ou logiciels) et les informations (ressources de données mises à disposition par des applications en ligne et web).
Aujourd’hui, les API constituent le socle des applications modernes, améliorent l’expérience utilisateur et enrichissent les modèles économiques. Parfois, une API peut même constituer à elle seule le modèle économique.
Comment fonctionnent les API ?
Les API sont la « vitrine » des applications : elles présentent les fonctions qu’elles exécutent et les informations qu’elles peuvent fournir, tout en définissant le format approprié des requêtes. Lorsqu’un développeur crée et rend accessible l’API d’une application, il permet à d’autres applications de communiquer avec celle-ci.
Dans de nombreux cas, les API font gagner un temps précieux aux développeurs en mettant à leur disposition des fonctions couramment utilisées. Plutôt que de reproduire les fonctionnalités d’une application existante, les développeurs peuvent les intégrer à leurs propres applications en effectuant des appels à l’API de l’application existante.
La manière dont chaque API est conçue, déployée et fonctionne dépend de son style architectural ou de son protocole.
Types d’architectures et de protocoles d’API
Une architecture d’API, ou style architectural, désigne la conception générale d’une API. Elle englobe la manière dont l’API est structurée et organisée, ainsi que son format de requête/réponse. Un protocole d’API définit également un format, tout en décrivant précisément les messages échangés.
Les architectures et protocoles d’API courants comprennent :
- REST – Également connu sous le nom de RESTful, ce style architectural repose sur les principes du transfert d’état représentationnel. Il utilise des méthodes HTTP (telles que GET, POST, PUT et DELETE) et des informations abstraites (sous forme de ressources et de modèles de ressources) pour créer des structures évolutives, flexibles et indépendantes des technologies. Aujourd’hui, REST reste l’architecture d’API la plus répandue.
- GraphQL – Langage de requête open source développé par Meta (anciennement Facebook), GraphQL permet de récupérer des données provenant de plusieurs sources en un seul appel d’API. Comme les clients ne demandent que les données nécessaires, les API GraphQL ont tendance à être plus efficaces (bien que moins faciles à mettre en cache) que les API REST.
- SOAP – Cette approche architecturale utilise le protocole simple d’accès aux objets (SOAP). Les messages SOAP sont généralement au format XML, ce qui les rend plus volumineux que ceux de REST ou de GraphQL. Contrairement aux API REST, les API SOAP sont soumises à des directives de mise en œuvre strictes qui définissent la structure du protocole de l’API.
- WebSocket – Ce protocole d’API est bidirectionnel simultané, ce qui signifie que le client et le serveur peuvent envoyer et recevoir des messages en même temps. En outre, le serveur peut envoyer un message qui ne répond pas à une requête du client, mais qui est, par exemple, déclenché par un événement côté serveur. À l’inverse, les API REST suivent un modèle requête-réponse strict.
- RPC – Avec un appel de procédure à distance, le développeur peut utiliser le même code pour appeler une fonction qui s’exécute dans un espace d’adressage différent (généralement sur un serveur distant) que pour une fonction locale, sans avoir à préciser les détails de l’interaction à distance. Comme plusieurs langages peuvent être utilisés, ce protocole est flexible et couramment employé dans les communications client-serveur. gRPC (Google Remote Procedure Call) est un exemple de RPC.
Comment les API sont-elles utilisées aujourd’hui ?
Les API sont un élément essentiel des logiciels modernes. Aujourd’hui, les organisations et les entreprises développent ou utilisent de nombreux types d’API en fonction de leurs besoins.
Les quatre types d’API les plus courants dans les organisations aujourd’hui sont les API publiques, les API privées, les API partenaires et les API tierces.
API publiques
Les API publiques sont accessibles aux utilisateurs extérieurs à votre entreprise (gratuitement ou contre paiement). Elles vous permettent de nouer des partenariats avec des développeurs tiers et d’étendre l’ensemble de votre écosystème commercial.
Parce que les API publiques peuvent être utilisées par des développeurs tiers pour créer de nouveaux produits, elles favorisent l’innovation et constituent un outil important pour nouer de nouveaux partenariats.
API privées
Les API privées sont accessibles uniquement aux équipes internes de votre entreprise. Elles vous permettent d’exploiter vos données et de favoriser la collaboration interne, ou peuvent prendre en charge, de manière invisible, les applications publiques de votre organisation (par exemple, votre site web).
Comme les API privées sont uniquement accessibles aux utilisateurs internes, les organisations peuvent les concevoir dans un souci d’optimisation. Elles offrent également une plus grande composabilité aux applications modernes, ce qui permet aux entreprises de s’adapter aux besoins actuels. Les développeurs peuvent facilement intégrer des API privées lors de la création de microservices, réduisant ainsi les tâches redondantes entre les équipes.
API partenaires
Les API partenaires permettent une intégration directe avec des partenaires commerciaux (par exemple, lorsqu’une compagnie aérienne s’associe à une chaîne hôtelière et que vous pouvez réserver simultanément votre vol et votre hébergement). Les API partenaires ne sont pas accessibles au public : elles sont réservées à certains développeurs qui satisfont aux exigences d’authentification (AuthN) et d’autorisation (AuthZ) des deux entreprises.
L’interopérabilité renforce les relations avec les API partenaires, car celles-ci décloisonnent les systèmes et permettent à différentes organisations de communiquer entre elles.
API tierces
Les API tierces sont utilisées par votre organisation pour accéder à des données ou à des fonctionnalités qui ne sont pas disponibles dans vos applications et services. Ces API s’exécutent sur le serveur du fournisseur tiers et proposent généralement un service largement utilisé (par exemple, l’API de traitement des paiements Stripe, employée par de nombreux sites d’e-commerce). Selon l’API, votre organisation peut les utiliser gratuitement ou moyennant des frais.
Étant donné que les API tierces sont déjà développées par un autre développeur ou une autre organisation, l’un de leurs avantages évidents est la réduction des coûts. En outre, elles permettent aux organisations de développer des applications plus rapidement, car les développeurs peuvent utiliser immédiatement une fonctionnalité au lieu de la coder eux-mêmes.
Quels langages de programmation sont utilisés pour créer des API ?
Presque tous les langages de programmation modernes peuvent être utilisés pour développer une API. Lorsqu’ils développent une API, de nombreux développeurs choisissent d’utiliser un framework. Les frameworks fournissent des composants de base, tels que des bibliothèques de code et d’autres utilitaires indispensables, qui permettent de créer des applications plus rapidement et plus facilement dans le langage choisi.
Chaque langage de programmation dispose généralement d’un ou de plusieurs frameworks populaires auprès des développeurs. Le tableau présente plusieurs frameworks possibles (dont beaucoup sont open source).
Langues
Cadres de travail
Java
JavaScript, Node.js
Angular, Express.js, React, Vue
PHP
Python
Rust
Ruby
Le choix du langage et du framework dépend généralement des besoins du projet ou des préférences personnelles du développeur.
Exemples d’API
Aujourd’hui, les organisations ont besoin d’une stratégie d’API moderne qui soit en phase avec leurs objectifs. Une stratégie d’API définit la manière dont une organisation concevra, développera, gérera, gouvernera et sécurisera ses API.
Selon Les 5 principaux enseignements de Gartner sur les API à l’intention des responsables de l’ingénierie logicielle, cinq bonnes pratiques permettent de garantir la solidité de votre stratégie d’API :
- Ne laissez pas la gouvernance des API créer des goulots d’étranglement. La gouvernance des API doit être conciliée avec l’agilité des développeurs afin de continuer à stimuler l’innovation.
- Traitez les API comme des produits, même si vous ne prévoyez pas de les monétiser. Assurez-vous que chaque API a un objectif et un public clairement définis, en adéquation avec les objectifs de l’entreprise.
- Découvrez vos API avant que les pirates ne le fassent. Donner la priorité à leur détection et à une surveillance régulière permet de prévenir les failles de sécurité.
- Gérez le cycle de vie des API. Une gestion complète du cycle de vie des API garantit qu’elles restent performantes tout en bénéficiant d’une sécurité adéquate.
- Choisissez les technologies d’API les mieux adaptées. Ce qui fonctionne pour une organisation ne conviendra pas nécessairement à la vôtre. Il est donc important d’examiner en détail vos besoins spécifiques en matière d’API, aujourd’hui comme à l’avenir.
Quel que soit le type d’architecture d’API que vous choisissez ou le type d’API que vous développez, il est essentiel de prendre en compte la sécurité des API dès le départ, et non après coup. Pour en savoir plus sur la manière de sécuriser vos API dès leur conception et de lutter contre des problèmes courants tels que la prolifération des API, consultez Sécurité des API : bonnes pratiques pour protéger les API.
Et tous les indicateurs ne se valent pas. Pour en savoir plus, consultez l’article « Les 12 indicateurs à surveiller pour une stratégie d’API réussie ».
Qu’est-ce que la connectivité des API ?
Si les API étaient à l’origine des outils destinés aux développeurs, elles sont devenues des actifs stratégiques qui augmentent le chiffre d’affaires et favorisent l’agilité des entreprises. La connectivité des API désigne l’utilisation d’API modulaires et réutilisables pour relier les données et les applications dans des environnements cloud natifs, afin de résoudre les problèmes de visibilité, de sécurité et de gouvernance.
