C'est quoi une API, expliqué simplement

Vous entendez « il faut brancher une API » et vous hochez la tête sans oser demander ce que c'est ? Voici l'explication, sans jargon.

L'image du restaurant

Dans un restaurant, vous ne rentrez pas en cuisine. Vous passez commande au serveur, la cuisine prépare, et le serveur vous apporte le plat.

Une API, c'est ce serveur. Une application demande quelque chose (« donne-moi la météo de Lyon »), un autre service répond (« voici : 14 °C, nuageux »). L'application n'a pas besoin de savoir comment la météo est calculée.

À quoi ça sert, concrètement

• afficher une carte dans votre application sans fabriquer une carte ;
• encaisser un paiement sans stocker de numéro de carte ;
• envoyer un e-mail de confirmation sans gérer un serveur de messagerie.

Chaque fois qu'un produit « se connecte à » un autre, il y a presque toujours une API entre les deux.

Ce qu'il faut retenir

Une API est un contrat : « si tu me demandes ça, de cette façon, je te réponds ça ».

Quand quelqu'un vous dit qu'une API « ne marche plus », c'est que le contrat a changé ou que l'un des deux côtés ne répond plus. Et c'est souvent là qu'il faut regarder en premier quand une application se met à dysfonctionner.