Formations — 1 037 leçons en français

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 Location qui 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 DELETE ou d'une mise à jour qui ne renvoie rien. Côté Angular, le corps vaut null : un type de retour Observable<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 renvoie 400 pour 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, PUT et DELETE sont idempotents par convention, POST non. C'est ce qui décide si le front peut réessayer automatiquement une requête échouée.

Lire l'explication détaillée et faire le quiz →

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.