C'est quoi une API ?

Le menu de ce que sait faire un serveur

⏱ Estim. ~4 min

01 · Lire

Une API (Application Programming Interface, interface de programmation) est un ensemble de règles qui définit quelles requêtes un serveur accepte et quelles réponses il renvoie.

Quand un dév construit un serveur, il ne laisse pas n'importe qui envoyer n'importe quelle requête. Il définit une API — une liste claire d'endpoints (URL) qu'on peut appeler, des données à envoyer, et de ce qu'on récupère en retour.

Chaque appli que tu utilises s'appuie sur des API. L'appli météo qui affiche la prévision appelle une API météo. Quand tu te connectes à un site, il appelle une API d'authentification. Quand tu scrolles un fil social, il appelle une API pour charger les prochaines publications.

💡 Imagine çaUne API, c'est comme la carte d'un restaurant. La carte te dit ce que tu peux commander, ce que chaque plat contient et combien ça coûte. Tu ne rentres pas en cuisine pour bricoler ton plat — tu choisis dans la carte. Une API fait pareil : elle indique à ton appli ce qu'elle peut demander au serveur.

Points clés

API = Application Programming Interface
Elle définit le « menu » des requêtes acceptées par le serveur
Chaque entrée du menu s'appelle un endpoint (une URL + méthode précise)
Les API permettent à des logiciels différents de communiquer sans connaître leurs détails internes

02 · Exemple de code

Voici à quoi ressemble une API typique pour un blog. Chaque endpoint combine une méthode HTTP et un chemin d'URL.

Blog API Endpoints

GET    /api/posts          → Get all blog posts
GET    /api/posts/15       → Get post #15
POST   /api/posts          → Create a new post
PUT    /api/posts/15       → Update post #15
DELETE /api/posts/15       → Delete post #15

User API Endpoints

GET    /api/users          → Get all users
GET    /api/users/42       → Get user #42's profile
POST   /api/users          → Create a new user (sign up)
PUT    /api/users/42       → Update user #42's profile
DELETE /api/users/42       → Delete user #42's account

Remarque le schéma : l'URL indique ce sur quoi tu agis (/posts ou /users), le nombre indique lequel exactement, la méthode HTTP indique ce que tu veux faire. Cette cohérence rend les API faciles à deviner et à utiliser.

03 · Quiz

Une appli météo sur mobile affiche la prévision du jour. Comment récupère-t-elle ces données ?

Les prévisions sont codées en dur dans l'appli
L'appli lit les capteurs du téléphone
L'appli appelle une API météo pour récupérer les dernières données
L'appli scrappe un site météo

04 · Compléter

Une API définit quelles _____ un serveur accepte.

Autres leçons de ce chapitre

⚠ L'expérience interactive complète nécessite JavaScript. Active-le et recharge la page.

※ Ce site est un projet éducatif indépendant — pas un produit officiel d'Anthropic. Claude™ est une marque déposée d'Anthropic, PBC.