들어가기 전에
RESTFul API 설계를 위한 기본적인 상태 코드
상태 코드가 필요한 이유는 오류가 발생할 경우 서버에서 클라이언트에 응답하기 위해서이다.
| 코드 | 설명 |
|---|---|
| 100 (Continue) | 서버가 요청의 초기부분을 수신하였고, 다음 요청을 기다리는 상태이다. |
| 101 (Switching Protocol | HTTP -> HTTPS 프로토콜 전환이 발생했을 때 전환이 승인됨을 알려주는 응답이다. |
| 200 (OK) | 요청에 대해서 성공을 알려주는 응답이다. |
| 201 (Created) | 요청에 대해 새롭게 생성되었음을 알려주는 응답이다. (POST 응답으로 적합) |
| 204 (No Content) | 요청에 대해서 성공했지만, 클라이언트로 보내는 컨텐츠가 없음을 응답한다. |
| 301 (Moved Permanently) | 요청한 리소스에 새로운 URI 가 할당되어 있음을 알려주는 응답이다. 새로운 주소로 이동한다. |
| 304 (Not Modified) | 요청을 수행했지만 문서가 수정되지 않았을 경우 알려주는 응답이다. |
| 307 (Temporary Redirect) | 요청된 리소스가 일시적으로 다른 URI 에 있음을 알려주는 응답이다. |
| 400 (Bad Request) | 잘못된 요청에 대해 실패 응답이다. |
| 401 (Unauthorized) | 요청에 대한 인증이 필요함을 뜻하는 응답이다. |
| 403 (Forbidden) | 요청에 대해서 거부를 뜻하는 응답이다. (권한 불충족) |
| 404 (Not Found) | 요청에 대해서 찾을 수 없는 페이지 응답이다. |
| 408 (Request Timeout) | 요청에 대해 시간이 초과되었을 때 응답이다. |
| 409 (Conflict) | 요청을 처리하는 과정에서 충돌을 알려주는 응답이다. |
| 500 (Internal Server Error) | 서버 내에서 에러가 발생하여 요청을 수행할 수 없음을 알려주는 응답이다. |
| 501 (Not Implemented) | 서버가 요청을 수행할 수 있는 기능을 지원하지 않음을 알려주는 응답이다. |
| 502 (Bad Gateway) | 서버에 요청했던 데이터가 중간에 유실되었음을 알려주는 응답이다. |
| 503 (Service Unavailable) | 서버가 다운 되었거나 유지보수 중일 때 알려주는 응답이다. (일시적인 현상) |
| 504 (Gateway Timeout) | 서버 게이트웨이에 문제가 생겨 요청에 대해 시간 초과 되었을 때 알려주는 응답이다. |