슬기로운 개발생활

HTTP 상태 코드 정리

by coco3o
반응형

상태 코드란?

상태 코드는 클라이언트와 서버 간의 통신상태를 나타내는 일련의 표준화된 코드 모음이다.

 

클라이언트는 해당 요청에 대한 실패, 처리완료 또는 잘못된 요청 등에 대한 피드백을

상태 코드를 통해 서버에게 보낸 요청이 어떻게 처리되었는지 알 수 있다.


상태 코드는 3자릿수 숫자로 만들어져 있으며, 각 첫번째 자리의 수로 그룹을 구분한다.

1xx : 정보 응답 / 2xx : 성공 응답 / 3xx : 리다이렉트 / 4xx : 클라이언트 요청 오류 / 5xx : 서버 오류

 

1XX : Information responses

: 요청을 받았으며 작업을 계속 진행

 

100 Continue 

진행 중임을 의미하는 응답 코드이다. 현재까지의 진행상태에 문제가 없으며,

클라이언트가 계속해서 요청을 하거나 이미 요청을 완료한 경우에는 무시해도 되는 것을 알려준다.

 

101 Switching Protocol

클라이언트에 의해 보낸 업그레이드 요청 헤더에 대한 응답으로 보내진다.

이 응답 코드는 클라이언트가 보낸 Upgrade 요청 헤더에 대한 응답에 들어가며, 서버에서 프로토콜을 변경할 것임을 알려준다.

해당 코드는 Websocket 프로토콜 전환 시 사용된다.

 

102 Processing

이 코드는 서버가 요청을 수신하였으며 이를 처리하고 있지만, 아직 제대로 된 응답을 알려줄 수 없음을 알려준다.

 

103 Early Hints

서버가 응답을 준비하는 동안 사용자 에이전트가 사전 로딩을 시작할 수 있도록 한다.

 

2XX : Successful responses

: 요청을 성공적으로 받았으며 처리했음

 

200 OK

요청을 정상적으로 처리함. 정보는 요청에 따른 응답으로 반환

 

201 Created

성공적으로 생성에 대한 요청을 받았으며 그 결과로 서버가 새 리소스를 작성 (일반적으로 POST 또는 PUT 요청의 응답)

 

202 Accepted

요청을 수신하였지만 아직 처리하지 않은 상태

 

203 Non-Authoritative Information

요청을 성공적으로 처리했지만 다른 소스에서 수신된 정보를 제공  (신뢰할 수 없는 정보)

 

204 No Content

요청을 성공적으로 처리했지만 제공할 컨텐츠는 없음

 

205 Reset Content

요청을 성공적으로 처리했지만 새로운 내용을 확인해야 함을 알려줌 (새로고침 등을 이용)

 

206 Partial Content

서버가 GET 요청의 일부만 성공적으로 처리했음을 알려줌 (클라이언트가 이어받기를 시도하면 웹서버가 이에 대한 응답코드로 '206 Partial Content'와 함께 Range 헤더에 명시된 데이터의 부분(byte)부터 전송을 시작)

 

207 Multi Status

여러 개의 리소스가 여러 Status Code를 갖고 있는 상황에서 적절한 정보 전달을 함.

 

3XX : Redirection messages

: 클라이언트의 요청에 대해 적절한 위치를 제공하거나 대안의 응답을 제공

 

300 Multiple Choice

클라이언트가 동시에 여러 응답이 가능한 요청을 보냈을 경우 클라이언트의 선택지를 반환

 

301 Moved Permanently

요청한 리소스의 URI가 변경되었음을 의미한다. (변경된 URI에 대한 정보와 함께 응답)

 

302 Found

요청한 리소스의 URI가 일시적으로 변경되었음 (향후에 재요청 할 시 원래 요청했던 URI로 요청해야함)

 

303 See Other

클라이언트가 요청한 작업을 하기 위해서 다른 URI에서 얻어야 할 때 서버가 클라이언트에게 줌

 

304 Not Modified

이전의 요청과 비교하여 달라진 것이 없음을 의미 (캐시를 목적으로 사용됨)

 

305 Use Proxy

Proxy를 통해 요청되어야 함

 

306 Unused

지금은 사용하지 않는 코드 (추후 사용을 위해 예약되어 있음)

 

307 Temporary Redirect

302와 동일한 의미를 가지나, 클라이언트가 보낸 HTTP 메소드도 변경하면 안됨

 

308 Permanent Redirect

요청한 리소스가 다른 URI에 위치하고 있음 301과 동일한 의미를 가지나, HTTP 메소드도 변경하면 안됨

 

※ 최초의 요청 방법(HTTP Method)를 유지하지 않고 GET으로 변경시키며 리다이렉트 하는 것이 301 또는 302이고,

원래의 HTTP Method를 유지하면서 리다이렉트 시키는 것이 307 또는 308이다. ※

 

4XX : Client error responses

: 클라이언트의 잘못된 요청

 

400 Bad Request

잘못된 문법으로 요청을 보내 서버가 이해할 수 없음을 의미

 

401 Unauthorized

클라이언트가 인증되지 않았거나, 유효한 인증 정보가 부족하여 요청이 거부됨

 

402 Payment Required

결제 시스템을 위해 만들어졌으나 현재는 사용하지 않음

 

403 Forbidden

클라이언트가 요청한 컨텐츠에 접근할 권한이 없음 (신원 인증은 되었지만 권한이 없음)

 

404 Not Found

클라이언트가 요청한 URI를 찾을 수 없음

 

405 Method Not Allowed 

클라이언트가 보낸 메소드가 해당 URI에서 지원하지 않음

 

406 Not Acceptable

클라이언트의 요청에 대해 응답할만한 컨텐츠가 없음

 

407 Proxy Authentication Required

401과 동일하나, proxy를 통해 인증해야 함

 

408 Request Timeout

요청에 응답 시간이 오래 걸려 요청을 끊음

 

409 Conflict

클라이언트의 요청이 서버의 상태와 충돌이 발생

 

410 Gone

요청한 URI가 더 이상 사용되지 않고 사라짐

 

411 Length Required

요청 헤더에 Content-length가 포함되어야 함

 

412 Precondition Failed

요청 헤더의 조건이 서버의 조건에 적절하지 않음

 

413 Payload Too Large

request payload가 서버에서 정의한 최대 크기보다 큼

 

414 URI Too Long

요청된 URI가 너무 길어서 처리할 수 없음

 

415 Unsupported Media Type

서버가 지원하지 않는 미디어 포맷을 요청함

 

416 Requested Range Not Satisfiable

요청 헤더에 있는 Range 필드가 잘못됨

 

417 Expectation Failed

요청 헤더에 있는 Expect 필드가 적절하지 않음

 

421 Misdirected Request

요청이 응답을 생성할 수 없는 서버로 지정됨

 

422 Unprocessable Entity

문법 오류로 인하여 처리할 수 없음

 

423 Locked

요청한 리소스에 접근하는 것이 잠겨있음

 

424 Failed Dependency

이전 요청이 실패했기 때문에 현재의 요청도 실패했음

 

426 Upgrade Required

지금의 프로토콜을 사용하여 요청을 처리하지 못함. 클라이언트가 업그레이드를 하면 처리 할 수도.(업그레이드 필요)

 

428 Precondition Required

필수 전제 조건 헤더가 누락됨

 

429 Too Many Requests

클라이언트가 지정된 시간에 너무 많은 요청을 보냄

 

431 Request Header Fields Too Large

요청한 헤더 필드가 너무 커서 처리 불가. 헤더 필드를 줄여서 다시 요청해야 함

 

451 Unavailable For Legal Reasons

클라이언트가 요청한 것은 정부에 의해 검열된 불법적인 리소스임을 알림

 

5XX : Server error responses

: 정상적인 클라이언트의 요청에 대해 서버의 문제로 인해 응답할 수 없음

 

500 Internal Server Error 

서버의 문제로 응답할 수 없음 (정확한 문제에 대해 구체적으로 설명불가)

 

501 Not Implemented

서버가 지원하지 않는 새로운 메소드를 사용하여 요청함 클라이언트 요청에 대해 서버가 수행할 수 있는 기능이 없음

 

502 Bad Gateway

서버 위의 서버에서 오류 발생 (proxy 혹은 gateway 등에서 응답)

 

503 Service Unavailable

현재 서버는 일시적으로 사용이 불가함 (일반적인 원인은 유지보수로 인한 중단, 서버 과부하)

 

504 Gateway Timeout

서버가 다른 서버로 요청을 보냈으나 delay 발생으로 처리 불가능

 

505 HTTP Version Not Supported

요청에 사용된 HTTP 버전은 서버에서 지원되지 않음

 

506 Variant Also Negotiates 

서버에 내부 구성 오류가 있음

 

507 Insufficient Storage

서버에 내부 구성 오류가 있음

 

508 Loop Detected

서버가 요청을 처리하는 동안 무한 루프를 감지

 

510 Not Extended

서버가 요청을 처리하려면 요청에 대한 추가 확장이 필요

 

511 Network Authentication Required

클라이언트가 네트워크 액세스를 얻기 위해 인증이 필요


참고 : MDN Web DOCs

 

반응형

블로그의 정보

슬기로운 개발생활

coco3o

활동하기