Méthodes et codes de statut

Ce que tu vas apprendre

• Les cinq méthodes courantes et ce que chacune exprime.
• Les codes de statut à connaître et leurs familles.
• Comment l'API de ton site de recettes les combine, et un piège de fetch.

La méthode dit l'intention

Dans une requête, la méthode indique ce que tu veux faire de la ressource visée. La même adresse peut répondre différemment selon la méthode.

Une requête GET ne doit pas contenir de corps. Les corps servent à POST, PUT et PATCH.

Idempotent ou pas

Une méthode est idempotente quand l'envoyer dix fois produit le même effet que l'envoyer une fois. D'après MDN, GET, PUT et DELETE le sont, POST et PATCH non.

Concrètement : supprimer deux fois la recette 2 laisse le même état final. Poster deux fois « Crêpes » crée deux recettes.

Le code de statut dit le résultat

La réponse commence par un code de statut à trois chiffres. Le premier chiffre donne la famille.

Les codes que tu croiseras le plus, avec leur sens selon MDN :

Un exemple complet

Voici les échanges d'une API de recettes bien conçue, avec méthode, adresse et code attendu :

GET    /api/recettes        ->  200  la liste
GET    /api/recettes/99     ->  404  recette inexistante
POST   /api/recettes        ->  201  recette créée
POST   /api/recettes (vide) ->  400  titre manquant
DELETE /api/recettes/2      ->  204  supprimée, rien à renvoyer
PUT    /api/recettes        ->  405  méthode non prévue

Tu écriras cette API au chapitre 5. Le bon code aide le client : il sait s'il doit corriger sa requête (4xx) ou réessayer plus tard (5xx).

Le piège de fetch

fetch, la fonction native du navigateur, ne considère pas un 404 ou un 500 comme une erreur. La promesse n'est rejetée que pour les vraies pannes, comme un réseau coupé. Il faut tester toi-même :

const reponse = await fetch('/api/recettes/99')
if (!reponse.ok) {
  throw new Error(`Statut de réponse : ${reponse.status}`)
}

reponse.ok vaut true pour les codes 2xx, et reponse.status donne le code.

À retenir

• La méthode exprime l'intention : GET lit, POST crée, PUT remplace, PATCH modifie en partie, DELETE supprime.
• GET, PUT et DELETE sont idempotentes, POST et PATCH non.
• Les codes 2xx disent la réussite, 4xx une erreur du client, 5xx une erreur du serveur.
• Utilise 201 pour une création, 204 sans contenu, 400 pour une entrée invalide, 404 pour l'absent.
• Avec fetch natif, teste reponse.ok : un 404 ne déclenche pas d'erreur tout seul.