À l’instar d’une interface uti­li­sa­teur qui permet la com­mu­ni­ca­tion entre l’homme et la machine, une API (Ap­pli­ca­tion Pro­gram­ming Interface) permet la com­mu­ni­ca­tion entre dif­fé­rentes ap­pli­ca­tions lo­gi­cielles. Grâce à ces in­ter­faces de pro­gram­ma­tion, les données peuvent être trans­fé­rées dans les deux sens de façon organisée, même lorsque les ap­pli­ca­tions ont été codées dans des langages de pro­gram­ma­tion dif­fé­rents.

Résumé

Une API est un point d’accès défini qui permet à un logiciel d’utiliser les fonctions ou les données d’un autre.

  • Une API stan­dar­dise l’échange de données et d’ins­truc­tions entre deux pro­grammes.
  • Elle sert à intégrer des services tiers (cartes, paiement, ré­ser­va­tion) sans les re­dé­ve­lop­per.
  • Une API fonc­tionne par requêtes et réponses ; les API REST s’appuient sur les méthodes du protocole HTTP.
  • On distingue les API privées, par­te­naires et publiques, ainsi que plusieurs ar­chi­tec­tures : REST, SOAP, GraphQL ou gRPC.
  • Des outils comme Postman ou curl per­met­tent de tester une API avant de l’intégrer.
API de IONOS pour dé­ve­lop­peurs
Gérez vos produits d'hé­ber­ge­ment grâce à notre puissante API
  • En­re­gis­tre­ments DNS
  • Ad­mi­nis­tra­tion SSL
  • Do­cu­men­ta­tion API

Qu’est-ce qu’une API ?

API signifie Ap­pli­ca­tion Pro­gram­ming Interface et se traduit par interface de pro­gram­ma­tion d’ap­pli­ca­tion. Une API permet à des pro­gram­meurs tiers d’accéder à une sélection de fonc­tion­na­li­tés. En quelque sorte, les in­ter­faces servent de point d’entrée dans un autre logiciel. L’API permet aux deux pro­grammes de com­mu­ni­quer entre eux, d’échanger des données et de donner des ordres. Cela fonc­tionne aussi bien avec des logiciels installés sur un or­di­na­teur qu’avec des ap­pli­ca­tions mobiles ou Web. Un programme in­di­vi­duel peut également être structuré de façon à ce que ses dif­fé­rents modules com­mu­ni­quent entre eux via des in­ter­faces.

Dé­fi­ni­tion : API

Une Ap­pli­ca­tion Pro­gram­ming Interface est une interface reliant dif­fé­rents pro­grammes entre eux afin de stan­dar­di­ser la trans­mis­sion des données et l’échange des ins­truc­tions entre les dif­fé­rentes parties d’un programme.

À quoi servent les API ?

De nos jours, de nombreux éditeurs de logiciels mettent des API à dis­po­si­tion afin de permettre aux pro­gram­meurs d’accéder plus fa­ci­le­ment aux com­po­sants de leurs logiciels. SAP, Amazon et Google proposent par exemple des API pour dif­fé­rents domaines d’ap­pli­ca­tion. Grâce à ces in­ter­faces, les dé­ve­lop­peurs peuvent exécuter des tâches diverses :

  • trans­mettre une ins­truc­tion du pro­gram­meur à un logiciel et recevoir sa réponse ;
  • insérer du contenu dans des services web ;
  • réu­ti­li­ser du code d’ap­pli­ca­tion grâce à une mise en réseau des pro­grammes ;
  • contrôler l’accès par d’autres pro­gram­meurs.

Au quotidien, les API sont par exemple utilisées pour les services web. Un in­ter­naute sou­hai­tant réserver un vol peut demander à un com­pa­ra­teur de trouver tous les vols et leurs prix vers une des­ti­na­tion précise, à une date précise. En cliquant sur « Re­cher­cher », le site Internet com­mu­nique avec les API des dif­fé­rentes com­pag­nies aériennes pour demander le prix des vols vers cette des­ti­na­tion. Cette demande est réalisée en quelques secondes seulement et le client obtient ra­pi­de­ment un aperçu des vols dis­po­nibles. Mais quel en est exac­te­ment le fonc­tion­ne­ment ?

Conseil

Vous souhaitez pro­gram­mer une ap­pli­ca­tion mobile ? Notre guide pour les débutants sur le Mobile App Design contient toutes les in­for­ma­tions es­sen­tielles.

Comment fonc­tion­nent les API ?

Même si elles profitent également à l’uti­li­sa­teur final, les API servent prin­ci­pa­le­ment aux pro­gram­meurs. En règle générale, une Ap­pli­ca­tion Pro­gram­ming Interface est mise à dis­po­si­tion par les dé­ve­lop­peurs d’un logiciel pour permettre aux pro­gram­meurs d’autres ap­pli­ca­tions de l’utiliser. L’interface de pro­gram­ma­tion détermine comment les in­for­ma­tions et les données doivent être reçues et renvoyées par les modules. Google publie par exemple son API pour permettre à d’autres pro­gram­meurs de connecter leurs propres ap­pli­ca­tions aux services de Google. Pour ce faire, Google définit un format que le logiciel externe doit respecter.

Dans la pratique, le principe est celui de la requête et de la réponse : l’ap­pli­ca­tion cliente envoie une requête à l’API, le service la traite et renvoie une réponse. Pour que le service sache qui l’appelle, l’accès est en général protégé, par exemple par une clé d’API ou par le protocole d’au­to­ri­sa­tion OAuth 2.0.

REST est un style d’ar­chi­tec­ture très apprécié pour la com­mu­ni­ca­tion entre les ap­pli­ca­tions, en par­ti­cu­lier sur le Web. Les API REST s’appuient sur les méthodes du protocole HTTP, comme GET pour lire une ressource ou POST pour en créer une. Les données sont le plus souvent échangées au format JSON. Ces règles simples fa­ci­li­tent gran­de­ment l’échange des in­for­ma­tions et per­met­tent aux pro­gram­meurs d’établir ra­pi­de­ment une connexion avec l’API.

Pour pouvoir mettre à dis­po­si­tion l’interface de pro­gram­ma­tion, la stan­dar­di­sa­tion est donc es­sen­tielle, quelle que soit l’ar­chi­tec­ture utilisée pour l’échange. En outre, il est également né­ces­saire d’apprendre aux autres pro­gram­meurs à utiliser cor­rec­te­ment l’interface. C’est la raison pour laquelle une API est souvent proposée avec une do­cu­men­ta­tion détaillée sur la syntaxe et les fonc­tion­na­li­tés.

GZvSYJDk-us.jpg Pour afficher cette vidéo, des cookies de tiers sont né­ces­saires. Vous pouvez consulter et modifier vos pa­ra­mètres de cookies ici.

Quels types d’API existe-t-il ?

On peut classer les API selon leur ac­ces­si­bi­lité et selon leur ar­chi­tec­ture.

Côté ac­ces­si­bi­lité, on distingue les in­ter­faces privées (ou internes), les in­ter­faces par­te­naires et les in­ter­faces publiques. Les in­ter­faces privées sont uni­que­ment mises à dis­po­si­tion au sein d’une en­tre­prise. Elles sont souvent utilisées pour connecter les fonc­tion­na­li­tés propres à l’en­tre­prise de façon à permettre aux col­la­bo­ra­teurs ou aux clients d’accéder à des réseaux privés. Les in­ter­faces par­te­naires ne sont ouvertes qu’à des par­te­naires com­mer­ciaux précis. Les in­ter­faces publiques sont mises à la dis­po­si­tion de chacun et peuvent souvent être utilisées en toute sim­pli­cité par les dé­ve­lop­peurs de logiciel. Google, Amazon, eBay, Meta et PayPal sont de bons exemples d’API publiques. En France, les API ouvertes par l’ad­mi­nis­tra­tion sont recensées dans le catalogue des API publiques de data.gouv.fr, ac­ces­sible via api.gouv.fr. De nombreux fa­bri­cants (par ex. Google) invitent ac­ti­ve­ment les dé­ve­lop­peurs à con­tri­buer au dé­ve­lop­pe­ment de leur API.

Côté ar­chi­tec­ture, quatre approches sont courantes :

  • REST : s’appuie sur HTTP et sur des res­sources iden­ti­fiées par une adresse ; très répandu pour les services web ;
  • SOAP : protocole fondé sur XML, utilisé notamment dans les en­vi­ron­ne­ments d’en­tre­prise ;
  • GraphQL : langage de requête qui permet au client de demander pré­ci­sé­ment les données dont il a besoin ;
  • gRPC : framework per­for­mant d’appel de procédure à distance (RPC), utilisé pour relier des services entre eux, mais aussi des ap­pli­ca­tions mobiles ou des na­vi­ga­teurs à des services backend.

Une API peut aussi se situer au niveau d’un système d’ex­ploi­ta­tion ou d’une bi­blio­thèque lo­gi­cielle, par exemple pour accéder à des fichiers ou à des com­po­sants matériels.

Quels sont les avantages d’une API ?

Les API pré­sen­tent certains avantages et s’adressent à dif­fé­rentes personnes : les uti­li­sa­teurs profitent autant des in­ter­faces de pro­gram­ma­tion que les dé­ve­lop­peurs internes ou externes.

Les dé­ve­lop­peurs équipant leurs pro­grammes avec de bonnes in­ter­faces de pro­gram­ma­tion peuvent compter sur une plus large diffusion. Les ap­pli­ca­tions avec de bonnes API sont en effet davantage ap­pré­ciées puisqu’elles per­met­tent à d’autres pro­gram­meurs d’interagir plus fa­ci­le­ment avec elles. Les dé­ve­lop­peurs externes peuvent con­si­dé­ra­ble­ment étendre la palette de fonc­tion­na­li­tés de leur propre logiciel en la rat­ta­chant à d’autres ap­pli­ca­tions. À terme, ce sont les uti­li­sa­teurs qui profitent de cette connexion via l’interface : ils peuvent combiner sans problème divers pro­grammes et bé­né­fi­cier de davantage de confort d’uti­li­sa­tion.

Exemple : les API et les SDK pour Google Maps

Google Maps est un exemple très connu d’in­té­gra­tion d’API. Ce célèbre service de cartes et de na­vi­ga­tion en ligne a été présenté en février 2005 et est depuis lors in­dis­pen­sable pour de nombreux uti­li­sa­teurs, que ce soit sur un or­di­na­teur ou en tant qu’ap­pli­ca­tion sur des smart­phones.

Sur la pla­te­forme Google Maps, les dé­ve­lop­peurs peuvent accéder à des SDK et à des API qu’ils pourront intégrer dans leurs propres ap­pli­ca­tions, pro­grammes et sites internet. Ils per­met­tent d’intégrer ra­pi­de­ment les fonc­tion­na­li­tés de Google Maps dans d’autres ap­pli­ca­tions. Grâce à l’API Maps Ja­vaS­cript, les pro­prié­taires de sites internet peuvent par exemple ajouter des cartes in­te­rac­tives en toute sim­pli­cité. Cette pos­si­bi­lité est par­ti­cu­liè­re­ment in­té­res­sante pour les boutiques et les res­tau­rants dont le succès com­mer­cial dépend souvent de la capacité de leurs clients à trouver leurs locaux. L’uti­li­sa­tion de ces API nécessite une clé d’API et peut être payante selon le volume d’uti­li­sa­tion.

Zxf1mnP5zcw.jpg Pour afficher cette vidéo, des cookies de tiers sont né­ces­saires. Vous pouvez consulter et modifier vos pa­ra­mètres de cookies ici.

Comment tester des API ?

Si vous souhaitez intégrer des Ap­pli­ca­tion Pro­gram­ming In­ter­faces dans des pro­grammes ou des ap­pli­ca­tions, vous devez tout d’abord les tester afin de vous assurer que tout fonc­tionne comme prévu et que les API ne mettent pas trop longtemps à répondre. Les dé­ve­lop­peurs écrivant leurs propres API doivent également les tester dans un premier temps. Heu­reu­se­ment, il est aujourd’hui re­la­ti­ve­ment simple de tester des API, en par­ti­cu­lier grâce à des outils comme Postman ou curl.

Postman permet de tester les appels API définis par l’uti­li­sa­teur. Les dé­ve­lop­peurs peuvent ainsi importer et tester les spé­ci­fi­ca­tions de leur API. D’autre part, Postman prend en charge les schémas de formats tels que OpenAPI ou GraphQL. Il est ainsi possible de tester les API à leur stade de départ comme à leur stade final de dé­ve­lop­pe­ment. Postman propose une offre gratuite limitée ainsi que des offres payantes dont le prix varie selon la taille de l’équipe et les fonc­tion­na­li­tés requises.

curl est un outil de ligne de commande per­met­tant de tester des API. Cette ap­pli­ca­tion requiert une bonne maîtrise de la ligne de commande. Elle n’est pas aussi simple à utiliser que Postman et ne comporte pas d’interface graphique. Cependant, curl est gratuit. Vous pouvez consulter la do­cu­men­ta­tion sur la page de do­cu­men­ta­tion de curl.

Postman curl
Offre gratuite limitée, offres payantes selon l’équipe Gratuit, open source
Basé sur une pla­te­forme Outil de ligne de commande
Postman permet de tester les API dans le détail curl est plus souvent utilisé pour consulter ra­pi­de­ment l’en-tête HTTP
Hé­ber­ge­ment Web
Hé­ber­ge­ment Web de pointe au meilleur prix
  • 3x plus rapide, 60 % d'éco­no­mie
  • Haute dis­po­ni­bi­lité > 99,99 %
  • Seulement chez IONOS : jusqu'à 500 Go inclus
Aller au menu principal