기타

[HTTP] HTTP 응답 상태 코드 모음

QUERY 2021. 9. 15. 03:51

 


HTTP 응답 상태 코드의 종류 및 의미

 

HTTP 응답 상태 코드(HTTP response status codes)의 종류와 각각의 의미에 대해 알아보겠습니다. HTTP 응답 상태 코드는 특정 HTTP 요청이 성공적으로 완료되었는지 여부를 나타냅니다. 응답은 세 자리 숫자로 반환되는데, 백의 자리 숫자에 따라 크게 5가지 그룹으로 나눠집니다.  

http-status-codes
http-status-codes

  • 응답 상태 코드가 (1**)인 경우, 정보 제공 응답(informational responses)을 의미합니다.
  • 응답 상태 코드가 (2**)인 경우, 성공적인 응답(successful responses)을 의미합니다.
  • 응답 상태 코드가 (3**)인 경우, 리디렉션(redirects)을 의미합니다.
  • 응답 상태 코드가 (4**)인 경우, 클라이언트 오류(client errors)를 의미합니다.
  • 응답 상태 코드가 (5**)인 경우, 서버 오류(server errors)를 의미합니다.

 

지금부터 각각의 그룹에 속한 응답 코드들의 종류와 각각의 의미에 대해 보다 구체적으로 살펴보도록 하겠습니다.


정보 제공의 응답 ( Informational responses )

 

100 Continue

이 중간 응답은 지금까지의 모든 것이 정상이며 클라이언트가 요청을 계속 진행하거나 요청이 이미 완료된 경우 응답을 무시해야 함을 나타냅니다.

 

101 Switching Protocol

이 코드는 클라이언트의 업그레이드 요청 헤더에 응답하여 전송되며 서버가 전환 중인 프로토콜을 나타냅니다.

 

102 Processing

이 코드는 서버가 요청을 수신하여 처리 중이지만 아직 사용할 수 있는 응답이 없음을 의미합니다.

 

103 Early Hints

이 상태 코드는 서버가 응답을 준비하는 동안 사용자 에이전트가 리소스 사전 로드를 시작할 수 있도록 연결 헤더에 주로 사용됩니다.

 

 


 


 

성공적인 응답 ( Successful Responses )

 

200 OK

요청이 성공했음을 의미합니다. 성공의 의미는 HTTP 메서드에 따라 다릅니다.

- GET: 리소스를 가져와서 메시지 본문에 전송합니다.
- HEAD: 표현 헤더는 메시지 본문 없이 응답에 포함됩니다.
- PUT 또는 POST: 작업 결과를 설명하는 리소스가 메시지 본문에서 전송됩니다.
- TRACE: 메시지 본문은 서버에서 수신한 요청 메시지를 포함합니다.

 

201 Created

요청이 성공하여 새 리소스가 생성되었습니다. 일반적으로 POST 요청 또는 일부 PUT 요청 후에 전송되는 응답입니다.

 

202 Accepted

요청을 수신하였지만 그에 응하여 행동할 수 없습니다. 이 응답은 요청 처리에 대한 결과를 이후에 HTTP로 비동기 응답을 보내는 것에 대해서 명확하게 명시하지 않습니다. 이것은 다른 프로세스에서 처리 또는 서버가 요청을 다루고 있거나 배치 프로세스를 하고 있는 경우를 위해 만들어졌습니다.

 

203 Non-Authoritative Information

이 응답 코드는 반환된 메타 정보가 원본 서버에서 사용할 수 있는 것과 정확히 동일하지는 않지만 로컬 또는 타사 복사본에서 수집되었음을 의미합니다. 이 옵션은 대부분 다른 리소스의 미러 또는 백업에 사용됩니다. 특정 경우를 제외하고, "200 OK" 응답이 이 상태보다 선호됩니다.

 

204 No Content

이 요청에 대해 보낼 내용은 없지만 헤더가 유용할 수 있습니다. 사용자-에이전트는 이 리소스에 대한 캐시 된 헤더를 새 헤더를 업데이트할 수 있습니다.

 

205 Reset Contetn

사용자-에이전트에게 이 요청을 보낸 문서를 재설정하도록 합니다.

 

206 Partial Contetn

이 응답 코드는 리소스 일부만 요청하기 위해 클라이언트에서 범위 헤더를 보낼 때 사용됩니다.

 

207 Multi-Status

여러 상태 코드가 적합한 상황에 대비하여 여러 리소스에 대한 정보를 전달합니다.

 

208 Multi-Status

여러 바인딩의 내부 멤버를 동일한 컬렉션에 반복적으로 열거하지 않도록 <dav:propstat> 응답 요소 내부에서 사용됩니다.

 

226 IM Used (HTTP Delta encoding)

서버가 GET 요청에 대한 리소스의 의무를 다 했고, 그리고 응답이 하나 또는 그 이상의 인스턴스 조작이 현재 인스턴스에 적용이 되었음을 알려줍니다.

 


리디렉션 ( Redirects )

 

300 Multiple Choice

요청에 대해서 하나 이상의 응답이 가능합니다. 사용자 에이전트 또는 사용자는 그중에 하나를 반드시 선택해야 합니다. 응답 중 하나를 선택하는 방법에 대한 표준화된 방법은 존재하지 않습니다.

 

301 Moved Permanently

요청한 리소스의 URL이 영구적으로 변경되었습니다. 응답에 새 URL이 제공됩니다.

 

302 Found

이 응답 코드는 요청된 리소스의 URI가 일시적으로 변경되었음을 의미합니다. 향후 URI의 추가 변경이 있을 수 있습니다. 따라서 클라이언트가 향후 요청도 이 URI를 사용해야 합니다.

 

303 See Other

서버는 GET 요청이 있는 다른 URI에서 요청된 리소스를 가져오도록 클라이언트에 지시하기 위해 이 응답을 보냈습니다.

 

304 Not Modified

캐싱 용도로 사용됩니다. 클라이언트가 동일한 캐시 된 응답 버전을 계속 사용할 수 있도록 응답이 수정되지 않았음을 클라이언트에 알립니다.

 

305 Use Proxy

이전 버전의 HTTP 기술 사양에서 정의되었으며, 요청한 응답은 반드시 프락시를 통해서 접속해야 하는 것을 알려줍니다. 이것은 프락시의 in-band 설정에 대한 보안상의 걱정으로 인하여 사라져 가고 있습니다.

 

306 Unused

이 응답 코드는 더 이상 사용되지 않으며, 현재는 추후 사용을 위해 예약되어 있습니다. 이것은 HTTP 1.1 기술사양 이전 버전에서 사용되었습니다.

 

307 Temporary Redirect

클라리언트가 요청한 리소스가 다른 URI에 있으며, 이전 요청과 동일한 메서드를 사용하여 요청해야 할 때, 서버가 클라이언트에 이 응답을 직접 보냅니다. 이것은 302 Found HTTP 응답 코드와 동일한 의미를 가지고 있으며, 사용자 에이전트가 반드시 사용된 HTTP 메서드를 변경하지 말아야 하는 점만 다릅니다: 만약 첫 요청에 POST가 사용되었다면, 두 번째 요청도 반드시 POST를 사용해야 합니다.

 

308 Permanent Redirect

이것은 리소스가 이제 HTTP 응답 헤더의 Location: 에 명시된 영구히 다른 URI에 위치하고 있음을 의미합니다. 이것은 301 Moved Permanently HTTP 응답 코드와 동일한  의미를 가지고 있으며, 사용자 에이전트가 반드시 HTTP 메서드를 변경하지 말아야 하는 점만 다릅니다: 만약 첫 요청에 POST가 사용되었다면, 두 번째 요청도 반드시 POST를 사용해야 합니다.

 

 


 


 

클라이언트 오류 ( Client Errors )

 

400 Bad Request

이 응답은 잘못된 문법으로 인하여 서버가 요청을 이해할 수 없음을 의미합니다.

 

401 Unauthorized

비록 HTTP 표준에서는 "미승인(unauthorized)"를 명확히 하고 있지만, 의미상 이 응답은 "비인증(unauthenticated)"을 의미합니다. 클라이언트는 요청한 응답을 받기 위해서는 반드시 스스로를 인증해야 합니다.

 

402 Payment Required

이 응답 코드는 나중에 사용될 것을 대비해 예약되었습니다. 첫 목표로는 디지털 결제 시스템에 사용하기 위하여 만들어졌지만 지금 사용되고 있지는 않습니다.

 

403 Forbidden

클라이언트는 콘텐츠에 접근할 권리를 가지고 있지 않습니다. 예를 들어 그들은 미승인이어서 서버는 거절을 위한 적절한 응답을 보냅니다. 401과 다른 점은 서버가 클라이언트가 누구인지 알고 있습니다.

 

404 Not Found

서버는 요청받은 리소스를 찾을 수 없습니다. 브라우저에서는 알려지지 않은 URL을 의미합니다. 이것은 API에서 종점은 적절하지만 리소스 자체는 존재하지 않음을 의미할 수도 있습니다. 서버들은 인증받지 않은 클라이언트로부터 리소스를 숨기기 위하여 이 응답을 403 대신에 전송할 수도 있습니다. 이 응답 코드는 웹에서 반복적으로 발생하기 때문에 가장 유명할지도 모릅니다.

 

405 Method Not Allowed

요청한 메서드는 서버에서 알고 있지만, 제거되었고 사용할 수 없습니다. 예를 들어, 어떤 API에서 리소스를 삭제하는 것을 금지할 수 있습니다. 필수적인 메서드인 GET과 HEAD는 제거될 수 없으며 이 에러 코드를 리턴할 수 없습니다.

 

406 Not Acceptable

이 응답은 서버 중심 콘텐츠 협상을 수행한 후, 웹 서버가 사용자 에이전트가 제공한 기준에 맞는 콘텐츠를 찾지 못할 때 전송됩니다.

 

407 Proxy Authentication Required

이것은 401과 비슷하지만 프록시에 의해 인증이 필요합니다.

 

408 Request Timeout

이 응답은 요청을 한지 시간이 오래된 연결에 일부 서버가 전송하며, 어떨 때에는 이전에 클라이언트로부터 어떠한 요청이 없었다고 하더라도 보내지기도 합니다. 이것은 서버가 사용되지 않는 연결을 끊고 싶어 한다는 것을 의미합니다. 이 응답은 특정 몇몇 브라우저에서 빈번하게 보이는데, Chrome, Firefox 27+, 또는 IE9와 같은 웹서핑 속도를 올리기 위해 HTTP 사전 연결 메커니즘을 사용하는 브라우저들이 해당됩니다. 또한 일부 서버는 이 메시지를 보내지 않고 연결을 끊어버리기도 합니다.

 

409 Conflict

요청이 서버의 현재 상태와 충돌할 때 이 응답이 전송됩니다.

 

410 Gone

이 응답은 요청한 콘텐츠가 서버에서 영구적으로 삭제되었으며, 전달해 줄 수 있는 주소 역시 존재하지 않을 때 보냅니다. 클라이언트가 그들의 캐시와 리소스에 대한 링크를 지우기를 기대합니다. HTTP 기술 사양은 이 상태 코드가 "일시적인, 홍보용 서비스"에 사용되기를 기대합니다. API는 알려진 리소스가 이 상태 코드와 함께 삭제되었다고 강요해서는 안된다.

 

411 Length Required

서버에서 필요로 하는 Content-Length 헤더 필드가 정의되지 않은 요청이 들어왔기 때문에 서버가 요청을 거절합니다.

 

412 Precondition Failed

클라이언트의 헤더에 있는 전제조건은 서버의 전제조건에 적절하지 않습니다.

 

413 Payload Too Large

요청 엔티티는 서버에서 정의한 한계보다 큽니다; 서버는 연결을 끊거나 혹은 Retry-After 헤더 필드로 돌려보낼 것이다.

 

414 URI Too Long

클라이언트가 요청한 URI는 서버에서 처리하지 않기로 한 길이보다 깁니다.

 

415 Unsupported Media Type

요청한 미디어 포맷은 서버에서 지원하지 않습니다, 서버는 해당 요청을 거절할 것입니다.

 

416 Requested Range Not Satisfiable

Range 헤더 필드에 요청한 지정 범위를 만족시킬 수 없습니다; 범위가 타깃 URI 데이터의 크기를 벗어났을 가능성이 있습니다.

 

417 Expectation Failed

이 응답 코드는 Expect 요청 헤더 필드로 요청한 예상이 서버에서는 적당하지 않음을 알려줍니다.

 

418 I'm a teapot

서버는 커피를 찻 주전자에 끓이는 것을 거절합니다.

 

421 Misdirected Request

서버로 유도된 요청은 응답을 생성할 수 없습니다. 이것은 서버에서 요청 URI와 연결된 스킴과 권한을 구성하여 응답을 생성할 수 없을 때 보내집니다.

 

422 Unprocessable Entity

요청은 잘 만들어졌지만, 문법 오류로 인하여 따를 수 없습니다.

 

423 Locked

리소스는 접근하는 것이 잠겨있습니다.

 

424 Failed Dependency

이전 요청이 실패하였기 때문에 지금의 요청도 실패하였습니다.

 

426 Upgrade Required

서버는 지금의 프로토콜을 사용하여 요청을 처리하는 것을 거절하였지만, 클라이언트가 다른 프로토콜로 업그레이드를 하면 처리를 할지도 모릅니다. 서버는 Upgrade (en-US) 헤더와 필요로 하는 프로토콜을 알려주기 위해 426 응답에 보냅니다.

 

428 Precondition Required

오리진 서버는 요청이 조건적이어야 합니다. 클라이언트가 리소스를 GET 해서, 수정하고, 그리고 PUT으로 서버에 돌려놓는 동안 서드파티가 서버의 상태를 수정하여 발생하는 충돌인 '업데이트 상실'을 예방하기 위한 목적입니다.

 

429 Too Many Requests

사용자가 지정된 시간에 너무 많은 요청을 보냈습니다("rate limiting").

 

431 Request Header Fields Too Large

요청한 헤더 필드가 너무 크기 때문에 서버는 요청을 처리하지 않을 것입니다. 요청은 크기를 줄인 다음에 다시 전송해야 합니다.

 

451 Unavailable For Legal Reasons

사용자가 요청한 것은 정부에 의해 검열된 웹 페이지와 같은 불법적인 리소스입니다.

 


서버 오류(server errors)

 

500 Internal Server Error

서버가 처리 방법을 모르는 상황이 발생했습니다. 서버는 아직 처리 방법을 알 수 없습니다.

 

501 Not Implemented

요청 방법은 서버에서 지원되지 않으므로 처리할 수 없습니다. 서버가 지원해야 하는 유일한 방법은 GET와 HEAD이다. 이 코드는 반환하면 안 됩니다.

 

502 Bad Gateway

이 오류 응답은 서버가 요청을 처리하는 데 필요한 응답을 얻기 위한 게이트웨이 역할을 하는 동안 잘못된 응답을 받았음을 의미합니다.

 

503 Service Unavailable

서버가 요청을 처리할 준비가 되지 않았습니다. 일반적인 원인은 유지보수를 위해 작동이 중단되거나 과부하가 걸렸을 때입니다. 이 응답과 함께 문제를 설명하는 사용자 친화적인 페이지가 전송되어야 한다는 점에 유의하십시오. 이 응답은 임시 조건에 사용되어야 하며, Retry-After: HTTP 헤더는 가능하면 서비스를 복구하기 전 예상 시간을 포함해야 합니다. 웹마스터는 또한 이러한 일시적인 조건 응답을 캐시 하지 않아야 하므로 이 응답과 함께 전송되는 캐싱 관련 헤더에 대해서도 주의해야 합니다.

 

504 Gateway Timeout

이 오류 응답은 서버가 게이트웨이 역할을 하고 있고, 제때 응답을 받을 수 없을 때 제공됩니다.

 

505 HTTP Version Not Supported

요청에 사용된 HTTP 버전은 서버에서 지원되지 않습니다.

 

506 Variant Also Negotiates

서버에 내부 구성 오류가 있다. 즉, 요청을 위한 투명한 콘텐츠 협상이 순환 참조로 이어진다.

 

507 Insufficiend Storage

서버에 내부 구성 오류가 있다. 즉, 선택한 가변 리소스는 투명한 콘텐츠 협상에 참여하도록 구성되므로 협상 프로세스의 적절한 종료 지점이 아닙니다.

 

508 Loop Detedcted

서버가 요청을 처리하는 동안 무한 루프를 감지했습니다.

 

510 Not Extended

서버가 요청을 이행하려면 요청에 대한 추가 확장이 필요합니다.

 

511 Network Authentication Required

511 상태 코드는 클라이언트가 네트워크 액세스를 얻기 위해 인증을 받아야 할 필요가 있음을 나타냅니다.

 


지금까지 HTTP 응답 상태 코드(HTTP response status codes)의 종류와 각각의 의미에 대해 알아보았습니다. 모든 상태 코드는 RFC 2616의 섹션 10에 정의되어 있습니다. 업데이트된 사항은 RFC 7231에서 확인할 수 있습니다. 만약, 위에 기재된 코드 이외의 응답을 받는다면, 해당 응답은 비표준 응답이며, 서버 개발자가 직접 정의한 응답입니다.