Signification
La requête a réussi et a créé une nouvelle ressource. L'en-tête Location pointe généralement vers elle.
Causes courantes
- Un POST sur une collection a créé un enregistrement
- Un PUT a créé une ressource à une nouvelle URL
Comment corriger
Côté client ou visiteur
Lisez l'en-tête Location pour obtenir l'URL de la nouvelle ressource, ou utilisez le corps renvoyé si l'API inclut l'objet créé.
Côté propriétaire du site ou de l’API
Incluez Location avec la nouvelle URL et, idéalement, la représentation créée. Ne renvoyez pas 201 si rien n'a été créé ; une nouvelle tentative idempotente qui trouve un élément existant peut renvoyer 200 ou 409.
Exemple de réponse
HTTP/1.1
HTTP/1.1 201 Created
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Location: /users/42
Content-Type: application/json
{
"id": 42,
"name": "Ada"
}Spécification
FAQ
› L'en-tête Location est-il obligatoire avec 201 ?
Il est fortement recommandé. Sans lui, les clients doivent deviner la nouvelle URL à partir du corps.
› Quelle différence entre 201 et 202 ?
201 signifie que la ressource existe déjà. 202 signifie que la requête a été acceptée et sera traitée plus tard.