Se creó un recurso nuevo.
Cuándo usarlo
Tras un POST que crea algo. Incluye una cabecera Location que apunte a ello.
A tener en cuenta
Envía una cabecera Location con la URL del nuevo recurso, y devuelve su representación en el cuerpo si los clientes la van a necesitar, lo que ahorra un GET posterior. Location puede ser relativa; los clientes la resuelven respecto a la URL de la solicitud. Los clientes HTTP no siguen Location en un 201, porque no es una redirección, así que tu código tiene que leer la cabecera por su cuenta.
Haz que la creación se pueda reintentar sin riesgo: un cliente que sufre un timeout a menudo reenviará el POST y creará un duplicado. Acepta una cabecera Idempotency-Key, como hace Stripe, o deja que los clientes hagan PUT a un ID que generan ellos mismos, y responde a la repetición con la respuesta original. Usa 202 en su lugar si el recurso solo existe cuando termina una tarea en segundo plano, y 409 cuando un valor único ya está ocupado.
Éxito (2xx)
Los códigos 2xx indican éxito: el servidor recibió, entendió y aceptó la solicitud.
Cómo se ve
HTTP/1.1 201 CreatedCómo enviarlo
| Node.js / Express | res.status(201).end() |
|---|---|
| Python / Flask | return '', 201 |
| nginx | return 201; |
Cómo comprobarlo
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/