C'est quoi une API ? Explication simple et exemples

Vous avez déjà payé sur un site sans jamais quitter la page, vu la météo dans une app qui ne possède aucune station météo, ou cliqué sur « Se connecter avec Google ». À chaque fois, une API a fait le travail à votre place. Voilà ce que c'est, en clair.

Une API, c'est quoi exactement ?

Une API (Application Programming Interface, ou interface de programmation) est une porte qu'un logiciel ouvre pour que d'autres logiciels viennent lui demander quelque chose. Elle définit ce qu'on a le droit de demander, dans quel format, et ce qu'on reçoit en retour. C'est un contrat entre deux systèmes, rien de plus.

L'image qui tient le mieux, c'est le serveur au restaurant. Vous commandez au menu, il transmet en cuisine, il revient avec l'assiette. Vous n'entrez pas en cuisine et ça vous arrange : tant que le menu ne bouge pas, la cuisine peut changer de four ou de chef sans que ça vous concerne. Une API, c'est ce menu.

Des APIs que vous utilisez déjà sans le savoir

La plupart des fonctions qui paraissent évidentes dans une app reposent sur l'API de quelqu'un d'autre. Quatre exemples croisés cette semaine :

• Le bouton « Payer » d'une boutique en ligne. Le site envoie le montant à Stripe ou PayPal via leur API et reçoit « accepté » ou « refusé ». Votre numéro de carte, lui, ne transite jamais par le site.
• La météo dans votre app de sport. L'app interroge l'API d'un service météo avec vos coordonnées GPS et affiche ce qu'elle reçoit.
• « Se connecter avec Google ». Le site demande à Google de confirmer votre identité. Google répond oui, avec votre e-mail. Votre mot de passe ne quitte jamais Google.
• Un chatbot intégré à un outil. À chaque message, l'outil appelle l'API d'un modèle d'IA et affiche la réponse renvoyée.

Le point commun : personne ne réécrit un moteur de paiement, un service météo ou un modèle de langage. On appelle celui d'un autre.

Le vocabulaire minimum pour suivre

Quatre mots suffisent à comprendre la plupart des conversations sur les APIs.

Endpoint : l'adresse précise qu'on appelle, du type https://api.exemple.fr/v1/meteo. Une API en expose plusieurs, une par type de demande.

Requête et réponse : vous envoyez une requête (« la météo à Lyon »), l'API renvoie une réponse. C'est un aller-retour, pas un tuyau ouvert en permanence.

JSON : le format de cette réponse, du texte structuré du genre {"ville": "Lyon", "temp": 18}. Lisible par un humain comme par n'importe quel langage, de Python à Go.

Clé d'API : votre badge d'accès. Elle identifie qui appelle, sert à facturer à l'usage et à couper le robinet en cas d'abus. Elle vit côté serveur, jamais dans le code d'une page web.

Reste le débat REST ou GraphQL. REST expose une adresse par ressource et renvoie tout ce qu'elle contient ; GraphQL expose une seule adresse et vous laisse réclamer exactement les champs voulus. REST reste le défaut, GraphQL prend l'avantage sur des données très imbriquées.

Pourquoi ça compte, même sans écrire une ligne de code

Une API décide si deux outils que vous payez déjà savent travailler ensemble. Votre CRM peut-il pousser une facture dans votre compta ? Votre boutique peut-elle déverser ses commandes dans un tableur ? La réponse tient à l'existence d'une API des deux côtés, pas à la bonne volonté des éditeurs.

Trois effets concrets. Vous automatisez des tâches répétitives que personne ne recopie plus à la main. Vous branchez une brique déjà faite (paiement, envoi d'e-mails, extraction de texte) au lieu de la développer, ce qui économise des semaines de développement sur mesure. Et vous restez libre de changer d'outil : l'API du nouveau se rebranche là où l'ancienne était.

C'est aussi le socle des agents IA qui appellent eux-mêmes des APIs pour chercher, réserver ou déclencher une action, au lieu de se contenter de répondre.

FAQ

Une API, est-ce payant ?

Ça dépend de qui la publie. Beaucoup d'APIs commerciales offrent un palier gratuit limité en nombre d'appels par mois, puis facturent à l'usage au-delà. D'autres sont totalement ouvertes, notamment les APIs d'open data publiques.

Une API et un site web, c'est pareil ?

Même moyen de transport (HTTP), destinataire différent. Un site renvoie une page HTML faite pour vos yeux, une API renvoie des données brutes faites pour être lues par un autre programme.

Faut-il savoir coder pour utiliser une API ?

Pour l'appeler directement, oui, un minimum. Mais des outils d'automatisation comme Zapier, Make ou n8n branchent des APIs entre elles depuis une interface graphique, sans écrire de code.

Sources

• MDN Web Docs : API (glossaire) : définition de référence, qui pose l'API comme un contrat entre le logiciel qui la propose et ceux qui l'utilisent