2012xx · Sucesso
HTTP 201 Created
O 201 Created informa que a requisição resultou na criação de um recurso novo, cujo endereço vem no header Location.
O que significa
Um recurso novo foi criado. A requisição foi recebida, entendida e aceita.
Quando usar
POST que cria registro — devolva o Location apontando para ele.
Especificação: RFC 9110
Causas comuns
- POST em uma coleção que criou um registro
- PUT em uma URL que ainda não existia e passou a existir
Como resolver
- Devolva sempre o header Location com a URL do recurso criado
- Inclua o recurso criado no corpo para poupar uma requisição ao cliente
- Se a criação for assíncrona e ainda não houver recurso, use 202 Accepted
Exemplo de resposta
HTTP/1.1 201 Created
Location: /api/pedidos/7f3a
Content-Type: application/json
{"id": "7f3a", "status": "aguardando_pagamento"}Perguntas frequentes
- O 201 precisa devolver corpo?
- Não é obrigatório, mas é recomendado. Devolver o recurso criado evita que o cliente precise fazer um GET logo em seguida só para conhecer os campos gerados pelo servidor.