Jusqu'à maintenant, notre Flask renvoyait du HTML pour des humains. Mais si tu veux créer une application mobile (iOS/Android) ou une app frontend (React/Vue), elles ne veulent pas du HTML. Elles veulent des données brutes (JSON).
C'est ça, une API (Application Programming Interface).
L'architecture REST (Representational State Transfer)
C'est une façon standard d'organiser tes URL.
GET /users: Récupérer la liste des utilisateurs.POST /users: Créer un nouvel utilisateur.GET /users/1: Récupérer l'utilisateur n°1.PUT /users/1: Modifier (remplacer) l'utilisateur n°1.PATCH /users/1: Modifier partiellement l'utilisateur n°1 (juste changer son email par ex).DELETE /users/1: Supprimer l'utilisateur n°1.
C'est propre, c'est logique, c'est universel.
Les Codes HTTP (Langage universel)
Ton API ne parle pas français, elle parle HTTP.
- 200 OK : Tout va bien.
- 201 Created : J'ai bien créé la ressource (après un POST).
- 204 No Content : J'ai bien supprimé, y'a plus rien à voir.
- 400 Bad Request : Tu m'as envoyé des données pourries.
- 401 Unauthorized : T'es qui ? (Pas connecté).
- 403 Forbidden : Je sais qui t'es, mais t'as pas le droit.
- 404 Not Found : Ça n'existe pas.
- 500 Internal Server Error : J'ai planté (c'est ma faute).
Si tu suis ces conventions, n'importe quel développeur dans le monde pourra utiliser ton API sans douleur.