C’est quoi une API ?

En bref

Une API est un guichet par lequel un programme demande un service à un autre programme. Votre site s’en sert pour faire payer avec Stripe, afficher une carte Google Maps ou obtenir une réponse de Claude, sans avoir à tout fabriquer lui-même.

C’est comme le serveur au restaurant : vous ne passez pas en cuisine, vous lui donnez votre commande, il la transmet et vous rapporte le plat. Vous n’avez pas besoin de savoir cuisiner.

Les mots que vous entendrez : API clé d’API requête service en ligne

Voir sur la carte

Sur le site d’une pizzeria, vous cliquez sur « Payer » et une fenêtre de paiement par carte s’ouvre. Un peu plus bas, une petite carte montre où se trouve la boutique. La pizzeria n’a fabriqué ni la banque ni la carte du monde. Elle les a empruntées, grâce à des API.

Une API est un guichet : votre site y dépose une demande, un autre service fait le travail et lui rend la réponse.

À quoi sert une API ?

Un site ne sait pas tout faire. Encaisser une carte bancaire en toute sécurité, dessiner une carte de la France entière, rédiger une réponse intelligente : ce sont des métiers à part. Des entreprises spécialisées le font très bien et proposent leur service aux autres sites.

Pour que deux programmes travaillent ensemble, il faut une règle commune : comment poser la question, comment recevoir la réponse. Cette règle, c’est l’API. Les trois lettres veulent dire Application Programming Interface, soit en français « interface de programmation ». Retenez seulement « le guichet ».

Sur la carte de cette rubrique, les API mènent au bloc « Les services en ligne » : ce sont les guichets ouverts vers l’extérieur.

Au restaurant, vous ne rentrez pas en cuisine pour préparer votre plat. Vous lisez le menu, vous passez commande au serveur, il la transmet au chef, puis il vous rapporte l’assiette. Le menu, c’est la liste de ce qu’on a le droit de demander. Le serveur en salle, celui qui porte les assiettes (pas l’ordinateur de la page « serveur »), c’est l’API. Vous n’avez pas besoin de savoir ce qui se passe derrière la porte de la cuisine : vous recevez votre plat, c’est tout ce qui compte.

Comment ça marche concrètement ?

Reprenons le bouton « Payer » de la pizzeria. Voici ce qui se passe :

  1. Vous touchez « Payer » dans votre navigateur.
  2. Le code PHP du site, sur son serveur, prépare une demande : « Je voudrais encaisser 18€ pour ce client. »
  3. Il envoie cette demande par Internet à l’API de Stripe, un service de paiement. Le trajet est protégé par le HTTPS.
  4. Stripe vérifie la carte avec la banque et répond : « Paiement accepté » ou « Paiement refusé ».
  5. Le site lit la réponse, enregistre la commande dans sa base de données et vous affiche « Merci ! ».

Cette demande s’appelle une requête. La réponse revient sous une forme rangée, faite pour être lue par un programme et non par un humain.

Des exemples de votre quotidien

La clé d’API : votre badge

Un guichet ne sert pas n’importe qui. Pour utiliser une API, votre site doit présenter une clé d’API : une longue suite de lettres et de chiffres, remise par le service quand vous ouvrez un compte. Elle prouve que la demande vient bien de chez vous.

Beaucoup de services sont payants à l’usage. Chaque demande faite avec votre clé peut donc vous être facturée. Une clé qui traîne en public, c’est comme un badge d’entreprise perdu dans la rue avec votre carte bancaire attachée dessus.

Les règles à suivre :

Les mots qu’on vous dira

Ce que vous avez à retenir

Vous n’aurez jamais à écrire vous-même une requête. Ce travail revient au code du site, ou à la personne qui le construit. Retenez seulement trois choses : une API permet à votre site d’emprunter le savoir-faire d’un autre, elle s’ouvre avec une clé, et cette clé se garde comme celle de la maison.

Le jour où l’on vous propose d’ajouter un paiement, une carte ou une IA sur votre site, vous saurez de quoi il s’agit : brancher un guichet de plus.

Avec quoi l’API travaille

Les questions qu’on se pose

C’est quoi une API en termes simples ?

C’est un guichet qui permet à un programme de demander un service à un autre programme, par exemple à un site de demander un paiement à Stripe ou une carte à Google Maps.

À quoi sert une clé d’API ?

Elle prouve au service que la demande vient bien de votre site. Elle est secrète : quiconque la possède peut utiliser le service à vos frais.

Est-ce qu’une API est payante ?

Cela dépend du service. Certaines sont gratuites jusqu’à un certain nombre de demandes, d’autres sont facturées à l’usage, comme les paiements ou l’intelligence artificielle.

Faut-il savoir programmer pour utiliser une API ?

Pour la brancher, il faut du code, écrit par un développeur ou par un assistant IA. Pour s’en servir au quotidien, non : vous voyez seulement le résultat sur votre site.

Tous les mots du Web

Chez vous

Mon iPhoneLe navigateurL’URLLes cookiesLe cacheLe Wi-FiMa box internetLa fibre optiqueLe terminalSSHLe FTPLes e-mails à votre nom

Le chemin, dehors

L’antenne relais 4G / 5GLe satelliteInternetLe cadenas (HTTPS)Le DNSLe nom de domaineL’adresse IP

Le data center

Le data centerL’hébergeurLa baie de serveursLe serveurLe VPS

Dans votre VPS

Le pare-feuLe serveur webLe code (PHP)La base de donnéesL’assistant IALes sauvegardesLe système (Linux)

Les fichiers du site

Les fichiers du siteLe HTMLLes balises HTMLLe CSSLe site responsiveLe JavaScriptLes imagesL’image transparenteLe SVGWordPress et les CMS

Être trouvé sur Google

Le moteur de rechercheLe référencement (SEO)

Les services en ligne (Stripe, Claude…)

L’API