Created

2xx · 성공 (Success) 자주 쓰임

개요

201 Created는 요청이 성공했고 그 결과로 새 리소스가 생성되었음을 나타냅니다. 보통 POST나 PUT 요청에 대한 응답으로 쓰이며, 새로 만들어진 리소스의 URL을 Location 헤더에 담아 알려 줍니다.

응답 본문에는 흔히 생성된 리소스의 표현(예: 서버가 부여한 id, 생성 시각)이 포함되어, 클라이언트가 곧바로 그 리소스를 참조할 수 있게 합니다.

요청

POST /api/articles HTTP/1.1
Host: api.example.com
Content-Type: application/json

{"title":"Hello","body":"First post"}

응답

HTTP/1.1 201 Created
Location: /api/articles/1024
Content-Type: application/json

{"id":1024,"title":"Hello"}

app.post('/api/articles', (req, res) => {
  const id = db.insert(req.body);
  res.status(201).location(`/api/articles/${id}`).json({ id });
});

@app.post('/api/articles')
def create():
    aid = db.insert(request.json)
    return {'id': aid}, 201, {'Location': f'/api/articles/{aid}'}