MODULE 16 / 72

Les API REST : fonctionnement et communication

API = Application Programming Interface. C'est un contrat de communication entre deux programmes. Elle définit : comment demander quelque chose, et sous quelle forme recevoir la réponse.
REST est un style d'architecture (pas un protocole). Une API REST utilise les méthodes HTTP et traite les données comme des ressources identifiées par des URLs.
Les 4 opérations fondamentales (CRUD) : GET (lire), POST (créer), PUT/PATCH (modifier), DELETE (supprimer).
Les codes de statut HTTP sont essentiels : 200 (OK), 201 (créé), 400 (mauvaise requête), 401 (non authentifié), 403 (interdit), 404 (introuvable), 500 (erreur serveur).
JSON est le format universel d'échange : lisible par humains et machines, léger, structuré. Quand le frontend appelle le backend, il envoie et reçoit du JSON.
Alternative moderne : GraphQL — une API où le client demande exactement les données dont il a besoin, ni plus ni moins.
⚡ ANALOGIE — LE MENU D'UN RESTAURANT
L'API = le menu (ce qu'on peut demander, dans quel format). GET /users = 'donnez-moi la liste des plats'. POST /orders = 'je passe une commande'. Le JSON = la langue commune entre le serveur et le client. Les codes de statut = les réponses du serveur ('C'est prêt', 'Rupture de stock', 'Cuisine fermée').
📐 SCHÉMA
GET/api/users/42200 OK→ Récupère l'user #42
POST/api/orders201 Created→ Crée une commande
PATCH/api/users/42200 OK→ Modifie l'email
DELETE/api/orders/7204 No Content→ Supprime commande
💬 QUESTION INTERACTIVE
1/5
"Qu'est-ce que GraphQL et en quoi diffère-t-il de REST ?"
🎯 PIÈGE / QUESTION D'ENTRETIEN
Qu'est-ce qu'une API idempotente ?