Accueil › Fullstack Angular + Spring Boot › Choisir le bon code HTTP, et le traiter côté front
Choisir le bon code HTTP, et le traiter côté front
Le contrat d'APIdebutant
Le code de statut est la partie du contrat que le front lit en premier. Un intercepteur d'erreurs bien écrit raisonne presque uniquement sur lui.
Les codes à maîtriser pour une API CRUD :
| Situation | Code | Corps |
|---|---|---|
| Lecture réussie | 200 OK |
la ressource |
| Création réussie | 201 Created + Location |
la ressource créée |
| Suppression ou mise à jour sans retour | 204 No Content |
aucun |
| Données invalides (validation) | 400 Bad Request |
détail des champs en faute |
| Non authentifié ou session expirée | 401 Unauthorized |
— |
| Authentifié mais droit manquant | 403 Forbidden |
— |
| Ressource inexistante | 404 Not Found |
message |
| Conflit avec l'état actuel | 409 Conflict |
message métier |
| Bug côté serveur | 500 Internal Server Error |
message générique |
@PostMapping("/api/commandes")
public ResponseEntity<CommandeDto> creer(@RequestBody @Valid CreerCommandeRequest req) {
CommandeDto creee = service.creer(req);
URI emplacement = URI.create("/api/commandes/" + creee.id());
return ResponseEntity.created(emplacement).body(creee);
}
creer(req: CreerCommandeRequest) {
return this.http.post<Commande>('/api/commandes', req);
}
Deux principes qui évitent la plupart des débats : 4xx, c'est le client qui doit changer quelque chose ; 5xx, c'est au back de corriger. Et un 5xx ne doit jamais décrire l'erreur en détail à l'utilisateur.
Les termes à connaître
- Code de statut
Entier à trois chiffres qui résume le sort d'une requête : 2xx succès, 3xx redirection, 4xx faute du client, 5xx faute du serveur. C'est la première information que le front lit, avant même le corps de la réponse.
- 201 Created
Succès d'une création. Accompagné de l'en-tête
Locationqui donne l'URL de la ressource créée. Côté Spring :ResponseEntity.created(uri).body(dto).- 204 No Content
Succès sans corps de réponse. Typique d'un
DELETEou d'une mise à jour qui ne renvoie rien. Côté Angular, le corps vautnull: un type de retourObservable<void>est le bon choix.- 400 vs 422
400 Bad Request: la requête est mal formée ou ses données sont invalides.422 Unprocessable Content: la syntaxe est correcte mais le contenu est sémantiquement refusé. Spring renvoie400pour un échec de Bean Validation. Les deux sont défendables : l'important est de choisir une convention et de s'y tenir sur toute l'API.- 401 vs 403
401 Unauthorized: vous n'êtes pas (ou plus) authentifié — le front doit renvoyer vers la page de connexion.403 Forbidden: vous êtes authentifié mais le droit manque — renvoyer vers la connexion serait une boucle infinie. La distinction pilote directement le comportement de l'intercepteur front.- 409 Conflict
L'action entre en conflit avec l'état actuel de la ressource : doublon de clé unique, modification concurrente, transition de statut interdite. Message utile au front : « cette commande est déjà expédiée ».
- Idempotence
Propriété d'une opération qui, répétée avec les mêmes paramètres, produit le même état final.
GET,PUTetDELETEsont idempotents par convention,POSTnon. C'est ce qui décide si le front peut réessayer automatiquement une requête échouée.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.