Qu'est-ce qu'une API ? Guide pour débutants sur les interfaces de programmation
✦ Points clés
- Une API (interface de programmation d'application) est un intermédiaire qui permet à deux programmes de communiquer et d'échanger des données sans connaître leur fonctionnement interne.
- L'analogie classique est celle du serveur au restaurant : vous êtes le client, la cuisine est le serveur informatique et le serveur est l'API qui porte la commande et rapporte le résultat.
- La plupart des API web modernes suivent le style REST et utilisent quatre verbes HTTP : GET, POST, PUT et DELETE.
- Les codes de statut comme 200, 404 et 500 indiquent rapidement si une requête a réussi ou échoué, et pourquoi.
- Les clés d'API et les limites de débit protègent le service et contrôlent le nombre de requêtes autorisées par utilisateur.
Chaque fois que vous ouvrez une application météo, appuyez sur « Se connecter avec Google » ou voyez votre position apparaître sur une carte, une API travaille discrètement en coulisses. C'est la tuyauterie invisible qui rend possibles les applications connectées d'aujourd'hui. Mais qu'est-ce qu'une API exactement, et comment fonctionne-t-elle dans un langage accessible à un débutant ?
Qu'est-ce qu'une API ?
Une API, abréviation d'interface de programmation d'application, est un ensemble de règles convenues qui permet à deux programmes de communiquer. Voyez-la comme un contrat : le programme A sait que s'il envoie une requête dans un format précis, il recevra une réponse dans un format attendu. Aucun des deux n'a besoin de comprendre comment l'autre est construit à l'intérieur ; il suffit que les deux respectent les règles publiées.
Générateur de factures & devis
Factures pro calculées et imprimées/PDF en une minute.
Cette idée est puissante car elle sépare « ce que vous voulez » de « comment cela se réalise ». Lorsque vous demandez un itinéraire entre deux villes à un service de cartographie, peu vous importe quel algorithme il utilise ou sur quels serveurs il tourne. Vous voulez seulement envoyer un point de départ et d'arrivée et recevoir un trajet. L'API est la porte ordonnée par laquelle vous passez.
L'analogie du serveur au restaurant
La meilleure façon de saisir une API est d'imaginer un restaurant. Vous êtes assis à une table (vous êtes l'application qui veut quelque chose), et la cuisine est le serveur qui détient les données et les prépare. Vous n'entrez pas dans la cuisine et ne savez pas comment les plats sont cuisinés ; vous appelez plutôt le serveur. Le serveur est l'API : il prend votre commande sur le menu, la porte en cuisine dans un langage que les cuisiniers comprennent, et vous rapporte votre plat terminé.
Le menu lui-même compte dans cette analogie : il définit ce que vous pouvez commander et ce que vous ne pouvez pas. De même, chaque API publie une « documentation » qui fonctionne comme un menu, listant les requêtes disponibles, les données à envoyer et les résultats attendus. Vous êtes limité à ce qui figure au menu, et c'est en réalité une sécurité, pas une contrainte : cela évite le chaos et garde la cuisine en ordre.
Requêtes, réponses et le style REST
Chaque interaction avec une API web comporte deux parties : une requête que vous envoyez, et une réponse qui revient. La requête porte une adresse pointant vers la ressource souhaitée, le type d'opération, et parfois des données supplémentaires. La réponse porte le résultat, généralement au format JSON, un format texte léger que les humains comme les machines lisent facilement.
La plupart des API web suivent aujourd'hui un style appelé REST. Son idée centrale est que tout est traité comme une « ressource » ayant une adresse unique, et que vous interagissez avec ces ressources à l'aide de verbes HTTP standards. Ce style est devenu populaire car il est simple, organisé et bâti sur le protocole web que les navigateurs utilisent déjà.
Les quatre méthodes HTTP courantes
Lorsque vous travaillez avec une API REST, vous choisissez un « verbe » qui décrit ce que vous voulez faire d'une ressource. Le tableau ci-dessous résume les quatre méthodes les plus utilisées :
| Méthode | Objectif | Exemple |
|---|---|---|
| GET | Récupérer des données existantes sans les modifier | Afficher une liste d'articles |
| POST | Créer un nouvel élément | Ajouter un nouveau commentaire |
| PUT | Mettre à jour entièrement un élément existant | Modifier les détails de votre profil |
| DELETE | Supprimer un élément | Supprimer une photo d'un album |
Les codes de statut : le langage du succès et de l'échec
Après chaque requête, le service renvoie un « code de statut » à trois chiffres qui vous indique rapidement ce qui s'est passé. Les codes commençant par 2 signifient un succès, ceux commençant par 4 signifient une erreur de votre côté, et ceux commençant par 5 signifient une erreur du serveur lui-même. Voici les plus courants :
| Code | Signification |
|---|---|
| 200 | La requête a réussi |
| 201 | Un nouvel élément a été créé avec succès |
| 400 | La requête est mal formée ou incomplète |
| 401 | Une connexion ou une clé valide est requise |
| 404 | La ressource est introuvable |
| 429 | Vous avez dépassé le nombre de requêtes autorisé |
| 500 | Une erreur interne du serveur s'est produite |
Clés d'API et limites de débit
De nombreux services exigent une « clé d'API », une chaîne secrète de lettres et de chiffres jointe à chaque requête pour identifier qui vous êtes. Une clé est comme une carte de membre : elle permet au service de vérifier votre identité, de compter votre usage et de vous couper l'accès en cas d'abus. C'est pourquoi vous devez garder votre clé secrète et ne jamais la publier ouvertement dans votre code.
Pour protéger les serveurs de la surcharge, la plupart des API imposent des « limites de débit », c'est-à-dire un nombre maximal de requêtes sur une période donnée, par exemple mille requêtes par heure. Si vous franchissez cette limite, le service renvoie le code 429 et vous demande d'attendre. Ces limites garantissent l'équité entre les utilisateurs et empêchent qu'une seule partie n'accapare les ressources.
Un exemple pas à pas : l'application météo
Suivons ce qui se passe quand vous ouvrez l'application météo sur votre téléphone. D'abord, l'application détermine votre position et prépare une requête GET vers l'API du service météo, en y joignant les coordonnées de votre ville et sa clé d'API. Ensuite, la requête atteint le serveur météo, qui vérifie que la clé est valide et que vous n'avez pas dépassé votre limite de débit.
Troisièmement, le serveur recherche les données météo de votre position et les emballe dans une réponse JSON contenant la température, l'humidité et le risque de pluie, accompagnée d'un code 200 signalant le succès. Quatrièmement, votre application reçoit ces données et les transforme en le bel écran que vous voyez : un soleil éclatant et « 28 degrés ». Tout cela se produit en moins d'une seconde, et vous n'avez jamais vu la moindre requête ni le moindre code ; vous n'avez vu que le résultat. C'est là l'essence d'une API : une énorme complexité cachée derrière une expérience simple.
Des exemples du quotidien tout autour de vous
Le bouton « Se connecter avec Google » est une autre API : au lieu de créer son propre système de mots de passe, le site demande à Google de vérifier votre identité et se contente de la réponse. Les cartes des villes intégrées aux applications de livraison proviennent d'une API de cartographie. Même le bouton de paiement en ligne appelle une API bancaire sécurisée. Une fois que vous prenez conscience de ces interfaces, vous les repérerez dans chaque application que vous ouvrez, travaillant en silence comme un serveur infatigable qui ne s'arrête jamais.