API의 상태 코드 중 201은 무엇을 의미하나요?

Q: API 상태 코드 201은 무엇을 의미하나요?

A: HTTP 상태 코드 201은 "Created"를 의미합니다. 이는 클라이언트가 요청한 작업이 성공적으로 수행되어 서버에 새로운 리소스가 생성되었음을 나타냅니다. 보통 POST 요청에 대한 응답으로 많이 사용되며, 서버는 새로 생성된 리소스의 URI를 Location 헤더에 포함시켜 클라이언트에게 제공합니다. 즉, 요청이 성공적이며 새로운 데이터가 작성되었음을 명확히 알려주는 상태 코드입니다.

HTTP 상태 코드 201은 "Created"를 의미합니다.

이 코드는 클라이언트의 요청이 성공적으로 처리되었으며, 그 결과로 새로운 리소스가 생성되었음을 나타냅니다.

주로 RESTful API에서 POST 요청을 통해 새로운 데이터를 생성할 때 사용됩니다.

201 상태 코드의 의미 1. 리소스 생성 : 201 상태 코드는 클라이언트가 요청한 작업이 성공적으로 수행되어 새로운 리소스가 생성되었음을 나타냅니다.

예를 들어, 사용자가 새로운 사용자 계정을 생성하기 위해 POST 요청을 보냈다면, 서버는 이 요청을 처리하고 새로운 사용자 계정이 생성되었음을 알리기 위해 201 상태 코드를 반환합니다.



2. Location 헤더 : 201 응답에는 종종 `Location` 헤더가 포함되어 있습니다.

이 헤더는 새로 생성된 리소스의 URI(Uniform Resource Identifier)를 포함하고 있어 클라이언트가 해당 리소스에 접근할 수 있도록 안내합니다.

예를 들어, 사용자가 새로운 블로그 포스트를 생성한 경우, 응답에 포함된 `Location` 헤더는 새로 생성된 블로그 포스트의 URL을 제공할 수 있습니다.



3. 응답 본문 : 201 상태 코드와 함께 응답 본문에 생성된 리소스의 세부 정보가 포함될 수 있습니다.

이는 클라이언트가 생성된 리소스에 대한 추가 정보를 즉시 확인할 수 있도록 도와줍니다.

예를 들어, JSON 형식으로 생성된 사용자 계정의 ID, 이름, 이메일 주소 등의 정보를 포함할 수 있습니다.

사용 예시 - 사용자 생성 : 클라이언트가 `/users` 엔드포인트에 POST 요청을 보내어 새로운 사용자를 생성할 때, 서버는 성공적으로 사용자를 생성하면 201 상태 코드를 반환합니다.

```http POST /users HTTP/1.1 Content-Type: application/json { "name": "John Doe", "email": "john.doe@example.com" } ``` 서버의 응답: ```http HTTP/1.1 201 Created Location: /users/123 Content-Type: application/json { "id": 123, "name": "John Doe", "email": "[email protected]" } ``` - 리소스 생성 후의 처리 : 클라이언트는 201 응답을 통해 새로운 리소스의 URI를 알게 되므로, 이후 해당 리소스에 대한 GET 요청을 통해 추가 정보를 조회할 수 있습니다.

결론 HTTP 상태 코드 201은 클라이언트의 요청이 성공적으로 처리되어 새로운 리소스가 생성되었음을 나타내는 중요한 코드입니다.

이 코드는 RESTful API 설계에서 리소스 생성 작업의 성공을 명확하게 전달하는 데 필수적이며, 클라이언트가 생성된 리소스에 대한 정보를 쉽게 접근할 수 있도록 돕습니다.