201 Created signifie que la requête a été satisfaite et qu’elle a créé une ou plusieurs nouvelles ressources. Les API le renvoient généralement après un POST sur une collection ou un PUT vers une nouvelle URL. La principale ressource créée est identifiée par l’en-tête Location, ou par l’URL de la requête en l’absence de Location.
Le corps décrit généralement la nouvelle ressource ou renvoie vers elle. Les validateurs présents dans la réponse, comme ETag, s’appliquent à la représentation nouvellement créée : le client peut donc s’en servir pour ses requêtes conditionnelles ultérieures.
Contrairement à ce qui se passe dans une réponse 3xx, un en-tête Location dans une réponse 201 n’est pas une redirection. Les navigateurs et les clients HTTP ne le suivent pas automatiquement.
Exemple de réponse
HTTP/1.1 201 Created
Date: Fri, 06 Nov 2026 10:15:32 GMT
Location: https://api.example.com/v1/orders/8412
Content-Type: application/json
Content-Length: 30
{"id":8412,"status":"pending"}SEO et vérification des redirections
Le code 201 concerne les API et les traitements de formulaires, pas les pages destinées à être indexées. Les robots d’exploration qui le reçoivent le considèrent comme un succès, mais l’URL d’une page publique doit renvoyer 200. Après l’envoi d’un formulaire dans le navigateur, la pratique habituelle consiste plutôt à répondre par 303 See Other, afin que le rechargement de la page de résultat ne soumette pas le formulaire une deuxième fois.
Causes fréquentes et cas d’usage
- Une API REST a créé un enregistrement (
POST /orders) et renvoie son URL dansLocation. - Un fichier a été envoyé avec
PUTvers une URL qui n’existait pas encore. - Une vérification des redirections affiche 201 pour une URL censée être une page : il s’agit d’un point de terminaison d’API, ou la vérification a utilisé POST. Contrôlez la méthode HTTP dans les Paramètres avancés.