C'est quoi, une API?

En bref : une API est une porte d’entrée officielle qui permet à un logiciel de demander quelque chose à un autre logiciel, selon des règles précises.

Vous avez peut-être déjà lu « disponible par API » ou « on l’a branché à l’API d’OpenAI ». Mais c’est quoi, au juste?

C’est quoi?

API veut dire Application Programming Interface, ou interface de programmation d’application. C’est un ensemble de règles qui permet à deux logiciels de se parler, sans que l’un ait besoin de savoir comment l’autre fonctionne à l’intérieur.

Une analogie : le serveur au restaurant

Vous ne vous rendez pas en cuisine. Vous lisez le menu, qui correspond à la documentation de l’API. Vous passez votre commande au serveur, c’est-à-dire la requête. La cuisine prépare le plat, et le serveur vous rapporte votre assiette, c’est-à-dire la réponse. Vous n’avez jamais vu la cuisine, et vous n’en avez pas besoin.

Comment ça marche, concrètement?

La plupart des API modernes passent par le Web. Une application envoie une requête à une adresse précise (un endpoint) :

• GET pour lire (« donne-moi la météo de Québec ») ;
• POST pour envoyer ou créer (« voici ma question pour l’IA ») ;
• PUT et DELETE pour modifier ou supprimer.

La réponse revient généralement en JSON, un format texte facile à lire pour les machines, avec un code qui indique le résultat : 200 si tout va bien, 401 si vous n’êtes pas autorisé, 404 si ce que vous cherchez n’existe pas, 429 si vous envoyez trop de requêtes.

🔑 La clé d’API

Pour savoir qui demande quoi, et qui paie, la plupart des services vous donnent une clé d’API, un long code secret envoyé avec chaque requête. Traitez-la comme un mot de passe : ne la publiez jamais, et ne la mettez pas dans un fichier partagé.

Des API, vous en utilisez tous les jours

• L’application météo de votre téléphone interroge l’API d’un service météo.
• Le bouton « Se connecter avec Google » utilise l’API de Google.
• Quand une IA comme ChatGPT est intégrée dans un autre logiciel, celui-ci l’appelle par son API, et la facture est calculée en tokens (voir « C’est quoi, un token? »).

API ou application : quelle différence?

L’application est faite pour vous, avec des boutons et des écrans. L’API est faite pour d’autres logiciels, avec des requêtes et des réponses. Souvent, le même service offre les deux.

À retenir

Une API est un contrat entre deux logiciels : voici ce que tu peux me demander, comment le demander, et ce que je te répondrai.

En très simple : Application → requête → API → réponse → Application