HTTP 상태 코드

3. 2xx (성공)

2xx (성공) 상태 코드는 클라이언트가 요청한 동작을 서버가 성공적으로 수신, 이해 및 처리했음을 의미한다.^[1]

각 상태 코드에 대한 간략한 설명은 다음과 같다.

• 200 OK (성공): 서버가 요청을 제대로 처리하여 요청한 페이지를 제공한다.
• 201 Created (작성됨): 요청이 성공하여 새 리소스가 생성되었다.
• 202 Accepted (접수됨): 서버가 요청을 접수했지만 아직 처리하지 않았다.
• 203 Non-Authoritative Information (신뢰할 수 없는 정보): 서버가 요청을 성공적으로 처리했지만 다른 소스에서 수신된 정보를 제공한다.
• 204 No Content (콘텐츠 없음): 서버가 요청을 성공적으로 처리했지만 콘텐츠를 제공하지 않는다.
• 205 Reset Content (콘텐츠 재설정): 서버가 요청을 성공적으로 처리했지만 콘텐츠를 표시하지 않으며, 요청자가 문서 보기를 재설정하도록 요구한다.
• 206 Partial Content (일부 콘텐츠): 서버가 GET 요청의 일부만 성공적으로 처리했다.
• 207 Multi-Status (다중 상태): WebDAV에서 사용되며, 여러 개의 개별 응답 코드를 포함할 수 있는 XML 메시지 본문을 가진다.
• 208 Already Reported (이미 보고됨): WebDAV에서 사용되며, DAV 바인딩의 멤버가 이미 열거되었으므로 다시 포함되지 않음을 나타낸다.
• 226 IM Used (IM 사용됨): 서버가 리소스에 대한 요청을 완료했으며, 응답은 현재 인스턴스에 적용된 하나 이상의 인스턴스 조작 결과에 대한 표현이다.

3. 1. 200 OK (성공)

3. 2. 201 Created (작성됨)

3. 3. 202 Accepted (접수됨)

3. 4. 203 Non-Authoritative Information (신뢰할 수 없는 정보)

3. 5. 204 No Content (콘텐츠 없음)

3. 6. 205 Reset Content (콘텐츠 재설정)

3. 7. 206 Partial Content (일부 콘텐츠)

3. 8. 207 Multi-Status (다중 상태)

3. 9. 208 Already Reported (이미 보고됨)

3. 10. 226 IM Used (IM 사용됨)

4. 3xx (리디렉션)

3xx 리디렉션 상태 코드는 클라이언트가 요청을 완료하기 위해 추가적인 조치를 취해야 함을 나타낸다.^[48] 이러한 상태 코드 중 다수는 URL 리디렉션에 사용된다.^[1] 사용자 에이전트는 GET 또는 HEAD 메서드로 두 번째 요청을 할 때만 사용자 상호 작용 없이 추가 조치를 할 수 있으며, 자동으로 요청을 리디렉션할 수 있다. 또한 순환 리디렉션을 감지하고 방지해야 한다.

각 상태 코드에 대한 간략한 설명은 다음과 같다.

• 300 (복수 응답): 서버가 요청에 따라 여러 조치를 선택할 수 있다.
• 301 (영구 이동): 요청한 페이지가 새 위치로 영구적으로 이동했다.
• 302 (임시 이동): 현재 서버가 다른 위치의 페이지로 요청에 응답하고 있지만, 요청자는 향후 요청 시 원래 위치를 계속 사용해야 한다.
• 303 (기타 위치 보기): 요청자가 다른 위치에 별도의 GET 요청을 하여 응답을 검색해야 한다.
• 304 (수정되지 않음): 마지막 요청 이후 요청한 페이지는 수정되지 않았다.
• 305 (프록시 사용): 요청자는 프록시를 사용하여 요청한 페이지만 접근할 수 있다.
• 306 (프록시 전환): 더 이상 사용되지 않는다.
• 307 (임시 리디렉션): 현재 서버가 다른 위치의 페이지로 요청에 응답하고 있지만, 요청자는 향후 요청 시 원래 위치를 계속 사용해야 한다.
• 308 (영구 리디렉션): 이 요청과 이후의 모든 요청은 주어진 URI로 리디렉션되어야 한다.

4. 1. 300 Multiple Choices (여러 선택)

4. 2. 301 Moved Permanently (영구 이동)

4. 3. 302 Found (발견됨)

4. 4. 303 See Other (다른 위치 보기)

4. 5. 304 Not Modified (수정되지 않음)

4. 6. 305 Use Proxy (프록시 사용)

4. 7. 306 Switch Proxy (프록시 전환)

4. 8. 307 Temporary Redirect (임시 리디렉션)

4. 9. 308 Permanent Redirect (영구 리디렉션)

5. 4xx (클라이언트 오류)

4xx 클래스의 상태 코드는 클라이언트에 오류가 있음을 나타낸다.

• 400 (잘못된 요청): 서버가 요청의 구문을 인식하지 못했다.
• 401 (권한 없음): 인증이 필요한 요청이다. 서버는 로그인이 필요한 페이지에 대해 이 요청을 제공할 수 있다. 상태 코드 이름이 권한 없음(Unauthorized)으로 되어 있지만 실제 뜻은 인증 안됨(Unauthenticated)에 더 가깝다.^[49]
• 402 (결제 필요): 결제가 필요한 요청이다.
• 403 (금지됨): 서버가 요청을 거부하고 있다. 사용자가 리소스에 대한 필요 권한을 갖고 있지 않은 경우를 예로 들 수 있다. (401은 인증 실패, 403은 인가 실패라고 볼 수 있음)
• 404 (찾을 수 없음): 서버가 요청한 페이지(Resource)를 찾을 수 없다. 서버에 존재하지 않는 페이지에 대한 요청이 있을 경우 서버는 이 코드를 제공한다.
• 405 (허용되지 않는 메소드): 요청에 지정된 방법을 사용할 수 없다. POST 방식으로 요청을 받는 서버에 GET 요청을 보내는 경우나, 읽기 전용 리소스에 PUT 요청을 보내는 경우가 그 예이다.
• 406 (수용할 수 없음): 요청한 페이지가 요청한 콘텐츠 특성으로 응답할 수 없다.
• 407 (프록시 인증 필요): 401(권한 없음)과 비슷하지만 요청자가 프록시를 사용하여 인증해야 한다. 서버가 이 응답을 표시하면 요청자가 사용할 프록시를 가리킨다.
• 408 (요청 시간초과): 서버의 요청 대기가 시간을 초과하였다.
• 409 (충돌): 서버가 요청을 수행하는 중에 충돌이 발생했다. 서버는 응답할 때 충돌에 대한 정보를 포함해야 한다. PUT 요청과 충돌하는 PUT 요청에 대한 응답으로 이 코드를 요청 간 차이점 목록과 함께 표시해야 한다.
• 410 (사라짐): 요청한 리소스가 영구적으로 삭제되었을 때 서버는 이 응답을 표시한다. 404(찾을 수 없음) 코드와 비슷하며 이전에 있었지만 더 이상 존재하지 않는 리소스에 대해 404 대신 사용하기도 한다. 리소스가 영구적으로 이동된 경우 301을 사용하여 리소스의 새 위치를 지정해야 한다.
• 411 (길이 필요): 유효한 콘텐츠 길이 헤더 입력란 없이는 서버가 요청을 수락하지 않는다.
• 412 (사전조건 실패): 서버가 요청자가 요청 시 부과한 사전조건을 만족하지 않는다.
• 413 (요청이 너무 긺): 요청의 본문이 너무 길어 서버가 처리할 수 없다.
• 414 (요청 URI가 너무 긺): 요청 URI(일반적으로 URL)가 너무 길어 서버가 처리할 수 없다.
• 415 (지원되지 않는 미디어 유형): 요청이 요청한 페이지에서 지원하지 않는 형식으로 되어 있다.
• 416 (처리할 수 없는 요청범위): 요청이 페이지에서 처리할 수 없는 범위에 해당되는 경우 서버는 이 상태 코드를 표시한다.
• 417 (예상 실패): 서버는 Expect 요청 헤더 입력란의 요구사항을 만족할 수 없다.
• 418 (I'm a teapot): RFC 2324에 정의되어 있으며, 실제 HTTP 서버에서 구현될 것으로 예상되지 않는다.
• 421 (잘못된 요청)
• 422 (처리할 수 없는 엔티티) (WebDAV; RFC 4918)
• 423 (잠김) (WebDAV; RFC 4918): 접근하려는 리소스가 잠겨 있다.
• 424 (실패된 의존성) (WebDAV; RFC 4918)
• 425 (정렬되지 않은 컬렉션) (인터넷 초안)
• 426 (업그레이드 필요): 클라이언트는 업그레이드 헤더 필드에 주어진 프로토콜로 요청을 보내야 한다.
• 428 (전제조건 필요) (RFC 6585)
• 429 (너무 많은 요청) (RFC 6585): 사용자가 일정 시간 동안 너무 많은 요청을 보냈다.
• 431 (요청 헤더 필드가 너무 큼) (RFC 6585)
• 451 (법적인 이유로 이용 불가) (인터넷 초안)

5. 1. 400 Bad Request (잘못된 요청)

5. 2. 401 Unauthorized (권한 없음)

5. 3. 402 Payment Required (결제 필요)

5. 4. 403 Forbidden (금지됨)

5. 5. 404 Not Found (찾을 수 없음)

5. 6. 405 Method Not Allowed (허용되지 않는 메서드)

5. 7. 406 Not Acceptable (허용되지 않음)

5. 8. 407 Proxy Authentication Required (프록시 인증 필요)

5. 9. 408 Request Timeout (요청 시간 초과)

5. 10. 409 Conflict (충돌)

5. 11. 410 Gone (사라짐)

5. 12. 411 Length Required (길이 필요)

5. 13. 412 Precondition Failed (사전 조건 실패)

5. 14. 413 Payload Too Large (페이로드 너무 큼)

5. 15. 414 URI Too Long (URI 너무 김)

5. 16. 415 Unsupported Media Type (지원되지 않는 미디어 유형)

5. 17. 416 Range Not Satisfiable (처리할 수 없는 요청 범위)

5. 18. 417 Expectation Failed (예상 실패)

5. 19. 418 I'm a teapot (나는 주전자)

5. 20. 421 Misdirected Request (잘못된 요청)

5. 21. 422 Unprocessable Content (처리할 수 없는 콘텐츠)

6. 5xx (서버 오류)

5xx 오류는 서버가 유효한 요청을 명백하게 수행하지 못했음을 나타낸다.^[48]

숫자 "5"로 시작하는 응답 상태 코드는 서버가 오류를 감지했거나 요청을 수행할 수 없는 경우를 나타낸다. HEAD 요청에 응답하는 경우를 제외하고, 서버는 오류 상황에 대한 설명을 포함해야 하며, 일시적인 상태인지 영구적인 상태인지 나타내야 한다. 사용자 에이전트는 포함된 모든 엔터티를 사용자에게 표시해야 한다. 이러한 응답 코드는 모든 요청 메서드에 적용된다.

509, 520, 598, 599 상태 코드는 비공식적인 오류 코드이다.

• 520 (Unknown Error, 알 수 없음)
• 598 (네트워크 읽기 시간초과 오류, 알 수 없음)
• 599 (네트워크 연결 시간초과 오류, 알 수 없음)

6. 1. 500 Internal Server Error (내부 서버 오류)

6. 2. 501 Not Implemented (구현되지 않음)

6. 3. 502 Bad Gateway (불량 게이트웨이)

6. 4. 503 Service Unavailable (서비스를 사용할 수 없음)

6. 5. 504 Gateway Timeout (게이트웨이 시간 초과)

6. 6. 505 HTTP Version Not Supported (HTTP 버전이 지원되지 않음)

6. 7. 506 Variant Also Negotiates (변형도 협상)

6. 8. 507 Insufficient Storage (용량 부족)

6. 9. 508 Loop Detected (루프 감지됨)

6. 10. 510 Not Extended (확장되지 않음)

6. 11. 511 Network Authentication Required (네트워크 인증 필요)

7. 비공식 코드

다음 코드는 어떠한 표준에도 명시되어 있지 않다.

참조

_[1] 웹사이트 Hypertext Transfer Protocol (HTTP) Status Code Registry https://www.iana.org[...] Iana.org 2015-01-08
_[2] 문서 Emphasised words and phrases such as must and should represent interpretation guidelines as given by
_[3] 웹사이트 102 Processing – HTTP MDN https://developer.mo[...] 2023-07-25
_[4] 웹사이트 Create request with POST, which response codes 200 or 201 and content https://stackoverflo[...] 2015-10-16
_[5] 웹사이트 Mozilla Bugzilla Bug 187996: Strange behavior on 305 redirect, comment 13 https://web.archive.[...] 2003-03-03
_[6] 웹사이트 The GNU Taler tutorial for PHP Web shop developers 0.4.0 https://web.archive.[...] 2017-10-29
_[7] 웹사이트 Google API Standard Error Responses https://web.archive.[...] 2017-06-21
_[8] 웹사이트 Sipgate API Documentation https://api.sipgate.[...] 2018-07-10
_[9] 웹사이트 Shopify Documentation https://help.shopify[...] 2018-07-25
_[10] 웹사이트 Stripe API Reference – Errors https://stripe.com/d[...] 2019-10-28
_[11] 웹사이트 HTTP/1.1 Status Codes 400 and 417, cannot choose which http://serverfault.c[...] 2015-10-16
_[12] 문서 I'm a teapot https://www.google.c[...]
_[13] 뉴스 New Google Easter Egg For SEO Geeks: Server Status 418, I'm A Teapot https://web.archive.[...] Search Engine Land 2014-08-26
_[14] 웹사이트 Google's Teapot https://www.google.c[...] 2017-10-23
_[15] 웹사이트 Enable extra web security on a website https://help.dreamho[...] 2022-12-18
_[16] 웹사이트 I Went to a Russian Website and All I Got Was This Lousy Teapot https://www.pcmag.co[...] 2022-12-18
_[17] 웹사이트 An HTTP Status Code to Report Legal Obstacles https://tools.ietf.o[...] 2016-02-01
_[18] 웹사이트 What is the correct HTTP status code to send when a site is down for maintenance? https://stackoverflo[...] 2015-10-16
_[19] 웹사이트 218 This is fine – HTTP status code explained https://http.dev/218 2023-07-25
_[20] 웹사이트 framework/src/Illuminate/Foundation/Exceptions/Handler.php https://github.com/l[...] 2023-12-12
_[21] 웹사이트 draft-ietf-webdav-protocol-05: Extensions for Distributed Authoring on the World Wide Web -- WEBDAV https://datatracker.[...]
_[22] 웹사이트 Enum HttpStatus https://docs.spring.[...] org.springframework.http 2015-10-16
_[23] 웹사이트 Twitter Error Codes & Responses https://web.archive.[...] Twitter 2014-01-20
_[24] 웹사이트 HTTP Status Codes and SEO: what you need to know https://www.contentk[...] 2019-08-09
_[25] 웹사이트 Shopify API response status and error codes https://shopify.dev/[...] 2023-12-12
_[26] 웹사이트 Screenshot of error page https://web.archive.[...] 2009-10-11
_[27] 웹사이트 Using token-based authentication https://web.archive.[...] 2014-09-08
_[28] 웹사이트 HTTP Error Codes and Quick Fixes https://web.archive.[...] Docs.cpanel.net 2015-10-15
_[29] 웹사이트 SSL Labs API v3 Documentation https://github.com/s[...]
_[30] 웹사이트 Platform Considerations {{!}} Pantheon Docs https://web.archive.[...] 2017-01-05
_[31] 웹사이트 HTTP status codes – ascii-code.com https://web.archive.[...] 2016-12-23
_[32] 문서 Seen in 2017
_[33] 웹사이트 Error message when you try to log on to Exchange 2007 by using Outlook Web Access: "440 Login Time-out" https://support.micr[...] Microsoft 2013-11-13
_[34] 웹사이트 2.2.6 449 Retry With Status Code http://msdn.microsof[...] Microsoft 2009-10-26
_[35] 웹사이트 MS-ASCMD, Section 3.1.5.2.2 http://msdn.microsof[...] Msdn.microsoft.com 2015-01-08
_[36] 웹사이트 Ms-oxdisco http://msdn.microsof[...] Msdn.microsoft.com 2015-01-08
_[37] 웹사이트 The HTTP status codes in IIS 7.0 http://support.micro[...] Microsoft 2009-07-14
_[38] 웹사이트 ngx_http_request.h https://web.archive.[...] nginx inc. 2016-01-09
_[39] 웹사이트 ngx_http_special_response.c https://web.archive.[...] nginx inc. 2016-01-09
_[40] Webarchive "return\" directive" http://nginx.org/en/[...] 2018-03-01
_[41] 웹사이트 Troubleshooting: Error Pages https://web.archive.[...] Cloudflare 2016-01-09
_[42] 웹사이트 Error 520: web server returns an unknown error https://developers.c[...] Cloudflare
_[43] 웹사이트 527 Error: Railgun Listener to origin error https://developers.c[...] Cloudflare 2016-10-12
_[44] 웹사이트 Error 530 https://developers.c[...] Cloudflare 2019-11-01
_[45] 웹사이트 Troubleshoot Your Application Load Balancers – Elastic Load Balancing https://docs.aws.ama[...] 2023-05-17
_[46] 웹사이트 Warning – HTTP {{!}} MDN https://developer.mo[...] 2021-08-15
_[47] IETF HTTP Caching 2022-06
_[48] 간행물 Hypertext Transfer Protocol – HTTP/1.1. https://tools.ietf.o[...] IETF 1999-06
_[49] 웹인용 Understanding 403 Forbidden https://web.archive.[...] 2017-05-07