6. Response Status Codes

status-code 요소는 요청을 이해하고 충족시키려는 시도의 결과를 제공하는 세 자리 정수 코드다.

인식되지 않는 상태 코드 471이 클라이언트에 의해 수신된 경우, 클라이언트는 자신의 요청에 이상이 있다고 가정하고, 응답은 400 (Bad Request) 상태 코드를 받은 것처럼 취급할 수 있다

• 1xx (Informational): 요청이 수신되어 프로세스가 계속 진행됨

• 2xx (Successful): 요청이 성공적으로 수신, 이해 및 수락됨

• 3xx (Redirection): 요청을 완료하려면 추가 조치를 취해야 함

• 4xx (Client Error): 요청에 잘못된 구문이 포함되어 있거나 충족할 수 없음

• 5xx (Server Error): 서버가 유효한 요청을 수행하지 못함

6.1 Overview of Status Codes

기본적으로 캐시 가능으로 정의된 상태 코드(e.g., 이 명세의 200, 203, 206, 300, 301, 404, 405, 410, 414 및 501)의 응답은 메서드 정의나 명시적 캐시 제어 [RFC7234]에 달리 명시되지 않는 한 휴리스틱한 만료를 가진 캐시에 의해 재사용할 수 있으며, 다른 모든 상태 코드는 기본적으로 캐시 가능하지 않다.

6.2 Informational 1xx

1xx (Informational) 등급의 상태 코드는 요청된 조치를 완료하고 최종 응답을 보내기 전에 커넥션 상태 또는 요청 진행 상황을 전달하기 위한 중간 응답을 나타낸다. 1xx 응답은 status-line(헤더 부문의 끝을 알리는 빈 라인) 후 첫 번째 빈 라인에 의해 종료된다.

• HTTP/1.0은 1xx 상태 코드를 정의하지 않았으므로 서버는 1xx 응답을 HTTP/1.0 클라이언트에 전송해서는 안된다. (MUST NOT)

• 클라이언트는 최종 응답 전에 받은 1xx 응답 중 하나 이상을 구문 분석할 수 있어야 한다.(MUST)

• 사용자 에이전트는 예기치 않은 1xx 응답을 무시할 수 있다.(MAY)

6.2.1 100 Continue

100 (Continue) 상태 코드는 요청의 초기 부분이 수신되어 아직 서버에서 거부되지 않았음을 나타낸다. 서버는 요청이 완전히 접수되고 조치된 후 최종 응답을 보내려고 한다.

요청이 100-continue를 포함하는 Expect 헤더 필드를 포함할 경우, 100 응답은 Section 5.1.1에 설명한대로 서버가 요청 페이로드 본문을 수신하기를 원함을 나타낸다.

6.2.2 101 Switching Protocol

101 (Switching Protocols) 상태 코드는 서버가이 연결에서 사용되는 응용 프로그램 프로토콜의 변경에 대해 Upgrade 헤더 필드 ([RFC7230]의 섹션 6.7)를 통해 클라이언트의 요청을 이해하고 준수 할 의사가 있음을 나타냅니다. 서버는 101 응답을 종료하는 빈 줄 바로 다음에 전환 될 프로토콜을 나타내는 응답에 Upgrade 헤더 필드를 생성해야합니다.

6.3 Successful 2xx

2xx (Successful) 등급의 상태 코드는 클라이언트의 요청이 성공적으로 수신, 이해 및 수용되었음을 나타낸다.

6.3.1 200 OK

200 (OK) 상태 코드는 요청이 성공했음을 나타낸다. 이 명세에 의해 정의된 메서드에 대해, 페이로드의 의도된 의미는 다음과 같이 요약할 수 있다.

• GET : 대상 리소스의 표현

• HEAD : GET와 동일한 표현이지만 표현 데이터가 없는 경우.

• POST : 조치의 상태 또는 결과의 표시

• PUT, DELETE : 조치의 상태 표시

• OPTIONS : 통신 옵션의 표시

• TRACE : 엔드 서버에서 수신한 요청 메시지의 표현

CONNECT에 대한 응답 외에, 200 응답은 항상 페이로드를 가지고 있지만, 원서버는 0의 페이로드 본문을 생성할 수 있다. 페이로드가 필요 없는 경우, 원서버는 대신 204(No Content)를 전송해야 한다. CONNECT의 경우, 성공적인 결과가 200 응답 헤더 부문 직후에 시작되는 터널이기 때문에 페이로드가 허용되지 않는다.

200개의 응답은 기본적으로 캐시할 수 있다.

6.3.2 201 Created

201(Created) 상태 코드는 요청이 이행되어 하나 이상의 새로운 리소스가 생성되었음을 나타낸다.

201 응답 페이로드에는 일반적으로 생성된 리소스가 설명되고 링크된다.

6.3.3 202 Accepted

202 (Accepted) 상태 코드는 요청이 접수되었으나 처리가 완료되지 않았음을 표시한다.

202 응답은 의도적으로 모호하다. 그 목적은 사용자 에이전트의 서버 커넥션이 완료될 때까지 지속되도록 요구하지 않고 서버가 일부 다른 프로세스(아마도 하루에 한 번만 실행되는 배 치 지향 프로세스)에 대한 요청을 수락할 수 있도록 하는 것이다.

6.3.4 203 Non-Authoritative Information

203 (Non-Authoritative Information) 상태 코드는 요청이 성공적이었으나, 변환 프락시에 의해 원서버의 200 (OK) 응답으로부터 동봉된 페이로드가 수정되었음을 나타낸다 ([RFC7230]의 Section 5.7.2).

203 응답은 어떤 상태 코드로든 응답에 적용할 수 있다는 장점이 있는 214 Transformation Apply의 Warning 코드([RFC7234] Section 5.5)와 유사하다.

6.3.5 204 No Content

204 (No Content) 상태 코드는 서버가 요청을 성공적으로 이행했으며 응답 페이로드 본문으로 보낼 추가 콘텐츠가 없음을 나타낸다. 응답 헤더 필드의 메타데이터는 요청된 작업이 적용된 후 대상 리소스와 선택된 표현을 가리킨다.

예를 들어, PUT 요청에 대한 응답으로 204 상태 코드가 수신되고 응답에 Etag 헤더 필드가 포함된 경우 PUT은 성공했으며 ETag field-value은 대상 리소스의 새로운 표현을 위한 entity-tag가 포함되어 있다.

6.3.6 205 Reset Content

205 (Reset Content) 상태 코드는 서버가 요청을 이행했음을 나타내며, 사용자 에이전트가 요청을 보낸 "문서 보기"를 원서버에서 수신한 원래 상태로 재설정했다.

• 205 상태 코드는 추가 콘텐츠가 제공되지 않음을 의미하므로 서버는 205 응답에서 페이로드를 생성해서는 안 된다.(MUST NOT)

• 서버는 205 응답에 대해 다음 중 하나를 수행해야 한다.(MUST):

• a) 값이 0인 Content-Length 헤더 필드를 포함하여 응답의 0 길이 본문을 나타내라

• b) 청크 값을 가진 Transfer-Encoding 헤더 필드와 0 길이의 단일 청크로 구성된 메시지 본문을 포함하여 응답에 대한 0 길이의 페이로드로 나타내라

• c) 헤더 부문을 종료하는 빈 줄을 보낸 후 즉시 커넥션을 닫아라

6.4 Redirection 3xx

상태 코드의 3xx (Redirection) 등급은 요청을 이행하기 위해 사용자 에이전트의 추가 조치가 필요하다는 것을 나타낸다. Location 헤더 필드(Section 7.1.2)가 제공되는 경우, 사용자 에이전트는 특정 상태 코드를 이해하지 못하더라도 Location 필드 값이 참조하는 URI로 요청을 자동으로 리다이렉트 할 수 있다.

여기에 리다이렉트의 몇 가지 유형이 있다:

• 상태 코드 301(Moved Permanently), 302 (Found), 307 (Temporary Redirect)과 같이 Location 필드에서 제공하는대로 다른 URI에서 리소스를 사용할 수 있음을 나타내는 리다이렉트.

• 300 (Multiple Choices) 상태 코드에서와 같이 각각 원래의 요청 대상을 나타낼 수 있는 매칭 리소스의 선택을 제공하는 리다이렉트.

• 303 (See Other) 상태 코드에서와 같이 요청에 대한 간접적인 응답을 나타낼 수 있는 위치 필드로 식별된 다른 리소스로의 리다이렉트.

• 304 (Not Modified) 상태 코드에서와 같이 이전에 캐시된 결과로 리다이렉트.

6.4.1 300 Multiple Choices

300 (Multiple Choices) 상태 코드는 대상 리소스가 각각 더 구체적인 식별자를 가진 둘 이상의 표현을 가지고 있음을 나타내며, 사용자(또는 사용자 에이전트)가 해당 식별자 중 하나 이상으로 요청을 리디렉션하여 선호하는 표현을 선택할 수 있도록 대안에 대한 정보가 제공되고 있다.

6.4.2 301 Moved Permanently

301(Moved Permanently) 상태 코드는 대상 리소스에 새 영구 URI가 할당되었으며 이 리소스에 대한 향후 참조는 동봉된 URI 중 하나를 사용해야 함을 나타낸다.

6.4.3 302 Found

302 (Found) 상태 코드는 대상 리소스가 일시적으로 다른 URI 아래에 있음을 나타낸다.

참고: 역사적 이유로, 사용자 에이전트는 후속 요청에 대한 요청 메서드를 POST에서 GET로 변경할 수 있다.

6.4.4 303 See Other

303 (See Other) 상태 코드는 원래 요청에 대한 간접적인 응답을 제공하기 위한 Location 헤더 필드에 URI가 표시한 대로 서버가 사용자 에이전트를 다른 리소스로 리다이렉트 하고 있음을 나타낸다. 사용자 에이전트는 또한 리다이렉트 될 수 있는 URI(HTTP를 사용하는 경우 GET 또는 HEAD 요청)를 대상으로 검색 요청을 수행하여 최종 결과를 원래 요청에 대한 응답으로 제시할 수 있다. Location 헤더 필드의 새 URI는 유효한 요청 URI와 동등한 것으로 간주되지 않는다는 점에 참고한다.

HEAD 요청에 대한 응답을 제외하고, 303 응답의 표현에는 Location 헤더 필드에 제공된 동일한 URI 참조에 대한 하이퍼링크가 있는 짧은 하이퍼텍스트 노트가 포함되어야 한다

6.4.5 305 Use Proxy

305 (Use Proxy) 상태 코드는 이 명세의 이전 버전에서 정의되었으며 현재 더 이상 사용되지않는다.

6.4.6 306 (Unused)

306 상태 코드는 이 명세의 이전 버전에서 정의되었으며 더 이상 사용되지 않으며 코드가 예약되어 있다.

6.4.7 307 Temporary Redirect

• 307(Temporary Redirect) 상태 코드는 대상 리소스가 일시적으로 다른 URI에 상주하고 있다는 것을 나타내며, 사용자 에이전트는 해당 URI로 자동 리디렉션을 수행할 경우 요청 메서드를 변경 하면 안 된다.(MUST NOT)

참고: 이 상태 코드는 요청 메서드를 POST에서 GET로 변경할 수 없다는 점을 제외하고 302 (Found)와 유사하다.

6.5 Client Error 4xx

상태 코드의 4xx(Client Error) 등급은 클라이언트가 오류가 발생한 것으로 보인다는 것을 나타낸다.

6.5.1 400 Bad Request

400 (Bad Request) 상태 코드는 클라이언트의 오류로 인식되는 것(e.g., 잘못된 요청 구문, 잘못된 요청 메시지 프레임 또는 기만적인 요청 라우팅)으로 인해 서버가 요청을 처리할 수 없거나 처리할 수 없음을 나타낸다.

6.5.2 402 Payment Required

402 (Payment Required) 상태 코드는 향후 사용을 위해 예약되어 있다.

6.5.3 403 Forbidden

403 (Forbidden) 상태 코드는 서버가 요청을 이해했지만 승인을 거부함을 나타낸다. 요청이 금지된 이유를 공개하고자 하는 서버는, 응답 페이로드(있는 경우)에서 그 이유를 설명할 수 있다.

6.5.2 404 Not Found

404 (Not Found) 상태 코드는 원서버가 대상 리소스에 대한 현재 표현을 찾지 못했거나 존재하는 것을 공개하지 않으려는 것을 나타낸다. 404 상태 코드는 이러한 표현 부족이 일시적인지 영구적인지를 나타내지 않는다. 410 (Gone) 상태 코드는 원서버가 어떤 구성 가능한 수단을 통해 조건이 영구적일 가능성이 있다는 것을 알고 있는 경우 404 보다 선호된다.

6.5.5 405 Method Not Allowed

405(Method Not Not Attable) 상태 코드는 request-line에 수신된 메서드가 원서버에 의해 알려져 있지만 대상 리소스에는 지원되지 않음을 나타낸다.

• 원서버는 대상 리소스의 현재 지원되는 메서드 목록을 포함하는 405 응답에 Allow 헤더 필드를 생성해야 한다.(MUST)

6.5.6 406 Not Acceptable

406 (Not Acceptable) 상태 코드는 요청에서 수신된 사전 협상 헤더 필드(Section 5.3)에 따라 대상 리소스가 사용자 에이전트가 수용할 수 있는 현재 표현을 가지고 있지 않으며, 서버가 기본 표현을 제공하지 않음을 나타낸다.

6.5.7 408 Request Timeout

408(Request Timeout) 상태 코드는 서버가 대기할 준비가 된 시간 내에 완전한 요청 메시지 를 수신하지 않았음을 나타낸다.

• 408은 서버가 계속 대기하기 보다는 커넥션을 종료하기로 결정하였음을 의미하므로, 서버는 응답으로 “close” 커넥션 옵션([RFC7230]의 Section 6.1) 을 보내야한다.(SHOULD)

6.5.8 409 Conflict

409 (Conflict) 상태 코드는 대상 리소스의 현재 상태와 충돌하여 요청을 완료할 수 없음을 나타낸다.

PUT 요청에 대응하여 충돌이 발생할 가능성이 가장 높다. 예를 들어 버전 지정이 사용 중이고 PUT에 있는 표현에 이전 (서드 파티) 요청에 의해 수행된 리소스와 충돌하는 리소스의 변경사항이 포함된 경우, 원서버는 요청을 완료할 수 없음을 나타내기 위해 409 응답을 사용할 수 있다. 이 경우, 응답 표현에는 개정 이력에 기초한 차이를 병합하는 데 유용한 정보가 포함될 수 있다.

6.5.9 410 Gone

410 (Gone) 상태 코드는 대상 리소스에 대한 액세스를 원서버에서 더 이상 사용할 수 없으며 이 조건이 영구적일 가능성이 있음을 나타낸다. 원본 서버가 조건이 영구적인지 여부를 알 수 없거나 확인할 수 있는 기능이 없는 경우, 대신에 상태 코드 404(Not Found)를 사용해야 한다.

6.5.10 411 Length Required

411 (Length Required) 상태 코드는 서버가 정의된 Content-Length ([RFC7230]의 Section 3.3.2) 없 요청을 거부함을 나타낸다.

6.5.11 413 Payload Too Large

413 (Payload Too Large) 상태 코드는 요청 페이로드가 서버가 처리할 의향이 있거나 처리 할 수 있는 것보다 크기 때문에, 서버가 요청을 거부함을 나타낸다.

6.5.12 414 URI Too Long

414 (URI Too Long) 상태 코드는 요청 대상([RFC7230]의 Section 5.3)이 서버가 해석하려는 것보다 길기 때문에, 서버가 요청의 거부함을 나타낸다. 이 드문 조건은 클라이언트가 긴 쿼리 정보가 있는 GET 요청으로 POST 요청을 부적절하게 변환했을 때, 클라이언트가 “black hole” 리디렉션(예: 자체 접미사를 가리키는 리다이렉트된 URI 접두사)로 내려갔을 때, 또는 서버가 잠재적인 보안 구멍을 이용하려고 시도하는 클라이언트의 공격을 받을 때에만 발생할 수 있다.

6.5.13 415 Unsupported Media Type

415 (Unsupported Media Type) 상태 코드는 대상 리소스에 대해 이 메서드로 지원하지 않는 형식의 페이로드가 있기 때문에, 원서버가 요청을 거부함을 나타낸다. 형식 문제는 요청에 표현된 Content-Type 또는 Content-Encoding 또는 데이터를 직접 검사한 결과일 수 있다.

6.5.14 417 Expectation Failed

417 (Expectation Failed) 상태 코드는 요청의 Expect 헤더 필드(Section 5.1.1)에 주어진 기대치를 인바운드 서버 중 하나 이상이 충족할 수 없음을 나타낸다.

6.5.15 426 Upgrade Required

426 (Upgrade Required) 상태 코드는 서버가 현재 프로토콜을 사용하여 요청을 수행하기를 거부하지만 클라이언트가 다른 프로토콜로 업그레이드한 후 요청을 수행할 의사가 있음을 나 타낸다.

• 서버는 반드시 필요한 프로토콜을 나타내기 위해 426 응답으로 Upgrade 헤더 필드를 전송해야 한다.(MUST) ([RFC7230]의 Section 6.7).

예를 들어,

HTTP/1.1 426 Upgrade Required Upgrade: HTTP/3.0 Connection: Upgrade Content-Length: 53 Content-Type: text/plain

이 서비스는 HTTP/3.0 프로토콜 사용을 필요로 한다.

6.6 Server Error 5xx

상태 코드의 5xx (Server Error) 등급은 서버가 요청된 메서드를 잘못했거나 수행할 수 없음을 알고 있음을 나타낸다. HEAD 요청에 응답하는 경우를 제외하고, 서버는 오류 상황에 대한 설명과 일시적 조건인지 영구적인 조건인지를 포함하는 표현을 보내야 한다.

6.6.1 500 Internal Server Error

500 (Internal Server Error) 상태 코드는 서버가 요청을 이행하지 못하게 하는 예기치 않은 조건을 만났음을 나타낸다.

6.6.2 501 Not Implemented

501(Not Implemented) 상태 코드는 서버가 요청을 이행하는 데 필요한 기능을 지원하지 않음을 나타낸다. 이것은 서버가 요청 메서드를 인식하지 못하고 어떤 리소스에도 그것을 지원할 수 없을 때 적절한 대응이다.

6.6.3 502 Bad Gateway

502 (Bad Gateway) 상태 코드는 서버가 게이트웨이 또는 프락시 역할을 하는 동안 요청을 이행하려고 시도하는 동안 액세스한 인바운드 서버로부터 잘못된 응답을 수신했음을 나타낸다.

6.6.4 503 Service Unavailable

503 (Service Unavailable) 상태 코드는 서버가 현재 일시적인 과부하 또는 예정된 유지보수로 인해 요청을 처리할 수 없음을 나타내며, 이는 어느 정도 지연된 후에 완화될 가능성이 높다.

• 서버는 Retry-After 헤더 필드(Section 7.1.3)를 보내 클라이언트가 요청을 재시도하기 전에 대기할 시간을 제안할 수 있다.(MAY)

6.6.5 504 Gateway Timeout

504 (Gateway Timeout) 상태 코드는 서버가 게이트웨이 또는 프락시 역할을 하는 동안 요청을 완료하기 위해 액세스해야 하는 업스트림 서버로부터 적시에 응답을 받지 못했음을 나타낸다.

6.6.6 505 HTTP Version Not Supported

505 (HTTP Version Not Supported) 상태 코드는 서버가 요청 메시지에 사용된 HTTP의 주요 버전을 지원하지 않거나 지원을 거부함을 나타낸다.