Aller au contenu
Encyclopédie informatique Édition 2026

Les API et les services web

Quand une application de météo affiche les prévisions, quand un site marchand encaisse un paiement par carte ou quand une application de transport calcule un itinéraire, des programmes dialoguent en coulisses par des interfaces de programmation, les API. Une API est un contrat : elle indique comment demander un service à un logiciel, sans rien connaître de son fonctionnement interne. Cet article présente les API des bibliothèques et des systèmes, les services Web de première génération et l’architecture orientée services, puis les API Web d’aujourd’hui et leurs règles de conception, avant d’aborder la sécurité de ces portes d’entrée, devenues l’une des cibles favorites des attaquants.

Rubrique
Développement
Niveau
Débutant à avancé
Lecture
23 min (essentiel)
30 min (complet)
Révision
23 octobre 2026
Niveau de lecture :

En bref

  • Une API (interface de programmation, de l’anglais Application Programming Interface) est un ensemble documenté de fonctions qui permet à un programme d’utiliser les services d’un autre logiciel sans connaître son fonctionnement interne.
  • Les API peuvent être locales, comme celles d’une bibliothèque ou d’un système d’exploitation, ou distantes : un programme interroge alors un service à travers le réseau ; on parle d’API Web ou de services Web.
  • Autrefois, les services Web reposaient sur une famille de standards lourds fondés sur XML, un format de texte structuré par des balises, et l’on organisait les systèmes d’information en architecture orientée services.
  • Aujourd’hui dominent les API dites REST, un style fondé directement sur les requêtes ordinaires du Web, qui échangent le plus souvent des données dans un format texte léger, JSON (JavaScript Object Notation).
  • Une API publiée est une porte d’entrée vers des données : vérifier les droits à chaque requête, limiter le nombre d’appels et tenir l’inventaire des API exposées sont indispensables.

Prérequis conseillés : Les langages de programmation · HTTP et HTTPS

1Définition

Une API (de l’anglais Application Programming Interface, « interface de programmation d’application ») est un ensemble de fonctions qui permet d’accéder aux services d’une application, d’une bibliothèque ou d’un système, par l’intermédiaire d’un langage de programmation. On rencontre parfois le sigle développé en Application Programmable Interface ; la forme correcte est Application Programming Interface, et la traduction usuelle reste « interface de programmation ».

Une API fournit au développeur un certain niveau d’abstraction : elle lui masque la complexité de l’accès à un système ou à une application en proposant un jeu de fonctions standard, dont seuls les paramètres et les valeurs retournées sont connus. Une analogie reste parlante : le conducteur d’une voiture n’a pas besoin de connaître le fonctionnement mécanique du moteur pour conduire. Seule une interface lui est accessible, composée d’un volant, de pédales (accélérateur, embrayage, frein), de manettes (clignotants, phares, boîte de vitesses) et de boutons (feux de détresse, antibrouillard, klaxon). Le constructeur peut changer le moteur d’une génération à l’autre : tant que l’interface reste la même, le conducteur n’a rien à réapprendre (figure 1).

Grâce aux API, un développeur n’a donc pas à se soucier de la façon dont une application, locale ou distante, fonctionne, ni de la manière dont ses fonctions ont été programmées, pour pouvoir l’utiliser dans un programme. Une API peut être disponible pour un langage particulier, ou pour plusieurs langages de programmation.

votre programme r = meteo.   prevision("Lyon") # r : {"temp": 18} ignore tout de l’intérieur L’API : LE CONTRAT • nom de la fonction • paramètres attendus • forme de la réponse • erreurs possibles • conditions d’accès le service lui-même base de données calculs serveurs caché ; peut changer sans casser le contrat appel réponse L’ANALOGIE DE LA VOITURE l’interface : volant, pédales, manettes, boutons le moteur : inutile de le connaître
Figure 1. Une API est un contrat entre le programme qui demande un service et celui qui le rend.

2Les grandes familles d’API

2.1Les API des bibliothèques

Chaque langage est livré avec une bibliothèque standard, un ensemble de fonctions prêtes à l’emploi pour calculer, manipuler du texte, lire des fichiers ou se connecter au réseau (voir les fonctions). Son API est la liste de ces fonctions, avec leurs paramètres et leurs résultats. Quand un programme Python écrit math.sqrt(2), il utilise l’API du module math sans savoir comment la racine carrée est calculée (voir Python). Des milliers de bibliothèques supplémentaires, publiées par des tiers, étendent ces possibilités. Dans les langages à objets, l’API d’une bibliothèque se présente sous forme de classes et de méthodes (voir la programmation orientée objet).

2.2Les API des systèmes d’exploitation

Un programme ne manipule jamais directement le disque, l’écran ou la carte réseau : il demande au système d’exploitation de le faire pour lui, par des appels système (voir le système d’exploitation). Ces appels forment l’API du système : POSIX, une norme commune aux systèmes de la famille Unix, dont Linux et macOS, définit par exemple les fonctions open, read et write pour les fichiers ; Windows propose sa propre API, historiquement appelée Win32. Les systèmes des téléphones offrent de même des API pour accéder à l’appareil photo, à la localisation ou aux contacts, en demandant l’accord de l’utilisateur. Les navigateurs Web exposent aussi des API aux programmes JavaScript des pages, pour modifier la page, stocker des données ou utiliser la caméra (voir JavaScript).

2.3Les API du matériel et du graphisme

Pour afficher des images en trois dimensions, un jeu vidéo ne programme pas directement la carte graphique, dont le fonctionnement varie d’un modèle à l’autre : il passe par une API graphique, comme OpenGL et Vulkan, standards ouverts, ou DirectX chez Microsoft et Metal chez Apple. Le pilote de chaque carte traduit ensuite les appels de l’API dans le langage propre au matériel. C’est l’abstraction de la figure 1 appliquée au matériel : le même jeu fonctionne sur des cartes très différentes.

2.4Les API distantes

Une API peut enfin être distante : le service est rendu par un programme qui tourne sur un autre ordinateur, et l’appel voyage à travers le réseau. C’est le cas des services Web et des API Web, qui font l’objet de la suite de cet article. Les éditeurs de services distants fournissent souvent un kit de développement, ou SDK (de l’anglais Software Development Kit) : une bibliothèque qui enveloppe les appels réseau dans des fonctions ordinaires, pour plusieurs langages, ainsi que de la documentation et des exemples.

Il ne faut pas confondre API et cadriciel (en anglais framework) : avec une API, c’est votre programme qui appelle les fonctions quand il en a besoin ; avec un cadriciel, c’est le cadriciel qui organise l’application et appelle votre code aux moments prévus (voir les langages informatiques).

3Le contrat et son évolutionApprofondir

Le contrat d’une API comprend la signature de chaque fonction, c’est-à-dire son nom, ses paramètres et leurs types, le type de son résultat, mais aussi son comportement : les erreurs qu’elle peut signaler, ses limites, ses conditions d’utilisation. Il est décrit dans une documentation, qui est la véritable référence pour les développeurs qui l’utilisent.

Une fois publiée, une API ne peut plus changer librement : des programmes, parfois des milliers, en dépendent. On distingue les modifications compatibles, comme l’ajout d’une fonction ou d’un paramètre facultatif, qui ne gênent pas les programmes existants, et les modifications incompatibles, comme le renommage d’une fonction ou la suppression d’un champ, qui les cassent (exercice 4). Pour ces dernières, l’usage est :

  • d’annoncer longtemps à l’avance l’abandon d’une fonction, déclarée obsolète (en anglais deprecated), avant de la retirer ;
  • de numéroter les versions de façon explicite. La gestion sémantique des versions, très répandue, utilise trois nombres, MAJEUR.MINEUR.CORRECTIF : on augmente le premier pour une modification incompatible, le deuxième pour un ajout compatible, le troisième pour une simple correction ;
  • pour une API Web, de maintenir en parallèle l’ancienne et la nouvelle version pendant une période de transition, par exemple aux adresses /v1/ et /v2/.

Un ingénieur de Google, Hyrum Wright, a donné son nom à une observation devenue célèbre, la « loi de Hyrum » : avec suffisamment d’utilisateurs, tous les comportements observables d’une API finissent par être utilisés par quelqu’un, y compris ceux que la documentation ne promet pas. Changer l’ordre des résultats ou le texte d’un message d’erreur peut ainsi casser un programme qui en dépendait sans le dire.