오늘은 HTTP 통신 시, 서버에서 보내주는 응답 코드에 대해 간단히 정리해 보려고 합니다.
(개인적으로도 가끔 쉽게 찾아보려고 정리하는 겸 해서 게시물을 작성하였습니다.^^)
클라이언트(웹 브라우저)에서 서버에 어떠한 요청(리퀘스트, Request)를 하면 서버는 응답(리스폰스, Response)를 보내줍니다.
적절한 처리가 이루어져서 성공 응답과 함께 결과 값을 보내주기도 하고, 정상적인 처리가 되지 않은 경우에는 실패 응답과 함께 에러 정보를 보내주기도 합니다.
웹 개발자라면 기본적으로 서버가 정상 응답한 경우, 200 코드를 보내주는 것은 다들 알고 계실겁니다.
200을 포함하여 200번대 응답은 서버에서 정상적으로 처리하여 응답한 경우, 보내주는 값들입니다.
그리고 각 코드는 100번대 단위로 응답 코드가 구분되어 있습니다. (즉, 300번대끼리, 400번대끼리 유사한 형태의 응답 코드라는 의미입니다.)
이처럼 3자리 숫자의 첫번째 값(코드)만 보고도 어떤 종류의 응답인지 알 수 있는데요. 이 첫번째 값을 Response Class라고 합니다.
그럼 각 Response Code 에 따라서 어떤 응답을 나타내는지 한 번 볼까요?
Response Class Code |
Response Class 의미 |
설명 |
1 |
Informational (정보) |
리퀘스트를 받고, 처리 중에 있음. |
2 |
Success (성공) |
리퀘스트를 정상적으로 처리함. |
3 |
Redirection (리디렉션) |
리퀘스트 완료를 위해 추가 동작이 필요함. |
4 |
Client Error (클라이언트 오류) |
클라이언트 요청을 처리할 수 없어 오류 발생 |
5 |
Server Error (서버 오류) |
서버에서 처리를 하지 못하여 오류 발생 |
4번과 5번은 에러이기는 한데, 간단히 차이점을 설명하자면 4xx 에러는 클라이언트의 잘못된 요청으로 서버에서 처리하지 못한 것이고, 5xx 에러는 클라이언트의 요청은 문제가 없으나, 서버에서 처리중에 서버 문제로 인해 오류가 발생한 것이라고 생각하시면 됩니다.
아래는 자주 접하는 코드를 위주로 작성하였고, 더 상세한 정보는 아래 참고 자료의 위키피디아 링크를 참조해주세요.~
* 200 번대 응답(Response) : 성공(Success)
200 |
OK |
* 요청 정상 처리. |
204 |
No Content |
* 요청 정상 처리하였지만, 돌려줄 리소스 없음. * 응답에 어떠한 엔티티 바디(Entity Body)도 포함하지 않음. * 서버에서 처리 후, 클라이언트에 정보를 보낼 필요가 없는 경우 사용. |
206 |
Partial Content |
* Range가 지정된 요청인 경우, 지정된 범위만큼의 요청을 받았다는 것을 알려줌. |
* 300 번대 응답(Response) : 리디렉션(Redirection)
301 |
Moved Permanently |
* 요청된 리소스에는 새로운 URI가 지정되어 있기 때문에, 이후로는 새 URI를 사용해야 한다는 것을 나타냄. (영구적인 URI 변경) |
302 |
Found |
* 요청된 리소스에는 새로운 URI가 지정되어 있기 때문에, 이후로는 새 URI를 사용해야 한 다는 것을 나타냄. 301과 유사하지만, 302는 일시적인 URI 이동) |
303 |
See Other |
* 이 응답은 요청에 대한 리소스는 다른 URI에 있기 때문에 GET 메서드를 사용해서 얻어야 한다는 것을 나타냄. 302 코드와 같지만, 303은 리디렉션 위치를 GET 메서드를 통해 얻어야 한다고 명확하게 되어 있음. |
304 |
Not Modified |
* 요청한 리소스가 마지막 요청 이후 변경된 적이 없기 때문에 기존 클라이언트의 로컬 캐시 리소스를 사용하도록 알려줌. 300번대로 분류되어 있지만, 리디렉션과는 관계없는 처리를 함. |
307 |
Temporary Redirect |
* 임시로 페이지를 리다이렉트 함. |
* 400 번대 응답(Response) : 클라이언트 에러 (Client Error)
400 |
Bad Request |
* 클라이언트의 요청 구문이 잘못됨. * 브라우저는 이 응답을 200 OK 응답과 동일한 형태로 취급함. |
401 |
Unauthorized |
* 요청 처리를 위해 HTTP 인증(BASIC 인증, DIGEST 인증) 정보가 필요함을 알려줌. 접근 허용을 차단함. 최초 요청에는 인증 다이얼로그 표시하고, 두번째는 인증 실패 응답을 보냄. |
403 |
Forbidden |
* 접근 금지 응답. Directory Listing 요청(서버 파일 디렉토리 목록 표시) 및 관리자 페이지 접근 등을 차단하는 경우의 응답. (파일 시스템 퍼미션 거부, 허가 되지 않은 IP 주소를 통한 액세스의 거부 등) * 서버는 엔티티 바디에 접근 거부에 대한 이유를 명시하여 보낼 수 있음. |
404 |
Not Found |
* 클라이언트가 요청한 리소스가 서버에 없음 |
405 |
Mothod Not Allowed |
* 허용되지 않는 HTTP 메서드를 사용함. |
* 500 번대 응답(Response) : 서버 에러 (Server Error)
500 |
Internal Server Error |
* 서버에서 클라이언트 요청을 처리 중에 에러가 발생함. |
503 |
Service Unavailable |
* 서버가 일시적으로 요청을 처리할 수 없음. * 서버가 과부하 상태이거나 점검중이므로 요청을 처리할 수 없음을 알려줌. |
504 |
Gateway Timeout |
* 서버를 통하는 게이트웨이에 문제가 발생하여 시간이 초과됨. |
505 |
HTTP Version Not Supported |
* 해당 HTTP 버전에서는 지원되지 않는 요청임을 알려줌. |
* 참고 자료 : https://en.wikipedia.org/wiki/List_of_HTTP_status_codes
* 참고 서적 : 그림으로 배우는 Http & Network Basic
* HTTP 상태 코드 (HTTP Status Codes) 에 대한 정의를 포함하고 있는 문서.
RFC2616 참조 문서 : http://tools.ietf.org/html/rfc2616
RFC4918 참조 문서 : http://tools.ietf.org/html/rfc2616
RFC5842 참조 문서 : https://tools.ietf.org/html/rfc5842
RFC6585 참조 문서 : http://tools.ietf.org/html/rfc6585
'개발&컴퓨터 > API연동&기타' 카테고리의 다른 글
내 블로그 및 사이트에 접속한 사용자 공인 아이피 얻는 API 정보 (1) | 2022.08.29 |
---|---|
내 사이트에 구글 번역기 달기 (3) | 2015.02.03 |
다음에디터(Daum Editor) 연동 시, 에디터 입력창에 DEVELOPMENT MODE 가 뜬다면? (2) | 2015.01.08 |
내 블로그(또는 사이트에) 유튜브 영상 게시(공유)하기 + 옵션! (0) | 2014.09.01 |
페이스북 웹페이지 캐시 삭제하는 방법 (캐시 갱신) (0) | 2014.08.26 |