HTTP 상태 코드

Preface

 

HTTP 상태 코드에 익숙해지고자 보기 좋게 정리해둔다.

---

 

1. HTTP 기본 상태 코드

 

 

- 상태 코드

1. 1xx (Informational): 요청이 수신되어 처리중

→ 일반적으로 잘 사용하지 않는다.

 

2. 2xx (Successful): 요청 정상 처리

200 OK: 요청 성공

201 Created: 요청 성공해서 새로운 리소스가 생성됨

202 Accepted: 요청이 접수되었으나 처리가 완료되지 않았음
→ 일정 시간 뒤 처리하는 프로세스에서 사용

204 No Content: 요청을 성공적으로 처리했지만, 응답 Body에 보낼 데이터가 없음

 

3. 3xx (Redirection): 요청을 완료하려면 추가 행동 필요

- 리다이렉션의 종류
1. 영구 리다이렉션: 특정 리소스의 URI가 영구적으로 이동
→ 301, 308
2. 일시 리다이렉션: 특정 리소스의 URI를 일시적으로 이동
→302(주로 사용), 303, 307
3. 특수 리다이렉션: 결과 대신 캐시를 사용
→ 304


300 Multiple Choices: 사용하지 않음

301 Moved Permanently: 리다이렉트시 요청 메서드가 GET으로 변하고, 본문이 제거될 수도 있음

302 Found: 리다이렉트시 요청 메서드가 GET으로 변하고, 본문이 제거될 수 있음

303 See Other: 리다이렉트시 요청 메서드가 GET으로 변경

304 Not Modified: 캐시를 목적으로 사용

307 Temporary Redirect: 리다이렉트시 요청 메서드와 본문 유지

308 Permanent Redirect: 리다이렉트시 요청 메서드와 본문 유지

 

4. 4xx (Client Error): 클라이언트 오류, 잘못된 문법등으로 서버가 요청을 수행할 수 없음

401 Unauthorized: 클라이언트가 해당 리소스에 대한 인증이 필요함

403 Forbidden: 인증 자격 증명은 있지만, 접근 권한이 불충분하므로승인을 거부함

404 Not Found: 요청 리소스를 찾을 수 없음

 

5. 5xx (Server Error): 서버 오류, 서버가 정상 요청을 처리하지 못함

500 Internal Server Error: 서버 문제로 오류 발생

503 Service Unavailable: 서비스 이용 불가
→ 서버가 잠시 요청을 처리할 수 없으나 Retry-After 헤더 필드로 얼마뒤에 복구되는지 보낼 수 있다.

 

출처: https://www.inflearn.com/course/http-%EC%9B%B9-%EB%84%A4%ED%8A%B8%EC%9B%8C%ED%81%AC

모든 개발자를 위한 HTTP 웹 기본 지식 - 인프런 | 강의

 

 

 

2. 스프링에서 제공하는 상태 코드

 

/**
 * Status code (100) indicating the client can continue.
 */
int SC_CONTINUE = 100;

/**
 * Status code (101) indicating the server is switching protocols according to Upgrade header.
 */
int SC_SWITCHING_PROTOCOLS = 101;

/**
 * Status code (200) indicating the request succeeded normally.
 */
int SC_OK = 200;

/**
 * Status code (201) indicating the request succeeded and created a new resource on the server.
 */
int SC_CREATED = 201;

/**
 * Status code (202) indicating that a request was accepted for processing, but was not completed.
 */
int SC_ACCEPTED = 202;

/**
 * Status code (203) indicating that the meta information presented by the client did not originate from the server.
 */
int SC_NON_AUTHORITATIVE_INFORMATION = 203;

/**
 * Status code (204) indicating that the request succeeded but that there was no new information to return.
 */
int SC_NO_CONTENT = 204;

/**
 * Status code (205) indicating that the agent <em>SHOULD</em> reset the document view which caused the request to
 * be sent.
 */
int SC_RESET_CONTENT = 205;

/**
 * Status code (206) indicating that the server has fulfilled the partial GET request for the resource.
 */
int SC_PARTIAL_CONTENT = 206;

/**
 * Status code (300) indicating that the requested resource corresponds to any one of a set of representations, each
 * with its own specific location.
 */
int SC_MULTIPLE_CHOICES = 300;

/**
 * Status code (301) indicating that the resource has permanently moved to a new location, and that future
 * references should use a new URI with their requests.
 */
int SC_MOVED_PERMANENTLY = 301;

/**
 * Status code (302) indicating that the resource has temporarily moved to another location, but that future
 * references should still use the original URI to access the resource. This definition is being retained for
 * backwards compatibility. SC_FOUND is now the preferred definition.
 */
int SC_MOVED_TEMPORARILY = 302;

/**
 * Status code (302) indicating that the resource reside temporarily under a different URI. Since the redirection
 * might be altered on occasion, the client should continue to use the Request-URI for future requests.(HTTP/1.1) To
 * represent the status code (302), it is recommended to use this variable.
 */
int SC_FOUND = 302;

/**
 * Status code (303) indicating that the response to the request can be found under a different URI.
 */
int SC_SEE_OTHER = 303;

/**
 * Status code (304) indicating that a conditional GET operation found that the resource was available and not
 * modified.
 */
int SC_NOT_MODIFIED = 304;

/**
 * Status code (305) indicating that the requested resource <em>MUST</em> be accessed through the proxy given by the
 * <code><em>Location</em></code> field.
 */
int SC_USE_PROXY = 305;

/**
 * Status code (307) indicating that the requested resource resides temporarily under a different URI. The temporary
 * URI <em>SHOULD</em> be given by the <code><em>Location</em></code> field in the response.
 */
int SC_TEMPORARY_REDIRECT = 307;

/**
 * Status code (400) indicating the request sent by the client was syntactically incorrect.
 */
int SC_BAD_REQUEST = 400;

/**
 * Status code (401) indicating that the request requires HTTP authentication.
 */
int SC_UNAUTHORIZED = 401;

/**
 * Status code (402) reserved for future use.
 */
int SC_PAYMENT_REQUIRED = 402;

/**
 * Status code (403) indicating the server understood the request but refused to fulfill it.
 */
int SC_FORBIDDEN = 403;

/**
 * Status code (404) indicating that the requested resource is not available.
 */
int SC_NOT_FOUND = 404;

/**
 * Status code (405) indicating that the method specified in the <code><em>Request-Line</em></code> is not allowed
 * for the resource identified by the <code><em>Request-URI</em></code>.
 */
int SC_METHOD_NOT_ALLOWED = 405;

/**
 * Status code (406) indicating that the resource identified by the request is only capable of generating response
 * entities which have content characteristics not acceptable according to the accept headers sent in the request.
 */
int SC_NOT_ACCEPTABLE = 406;

/**
 * Status code (407) indicating that the client <em>MUST</em> first authenticate itself with the proxy.
 */
int SC_PROXY_AUTHENTICATION_REQUIRED = 407;

/**
 * Status code (408) indicating that the client did not produce a request within the time that the server was
 * prepared to wait.
 */
int SC_REQUEST_TIMEOUT = 408;

/**
 * Status code (409) indicating that the request could not be completed due to a conflict with the current state of
 * the resource.
 */
int SC_CONFLICT = 409;

/**
 * Status code (410) indicating that the resource is no longer available at the server and no forwarding address is
 * known. This condition <em>SHOULD</em> be considered permanent.
 */
int SC_GONE = 410;

/**
 * Status code (411) indicating that the request cannot be handled without a defined
 * <code><em>Content-Length</em></code>.
 */
int SC_LENGTH_REQUIRED = 411;

/**
 * Status code (412) indicating that the precondition given in one or more of the request-header fields evaluated to
 * false when it was tested on the server.
 */
int SC_PRECONDITION_FAILED = 412;

/**
 * Status code (413) indicating that the server is refusing to process the request because the request entity is
 * larger than the server is willing or able to process.
 */
int SC_REQUEST_ENTITY_TOO_LARGE = 413;

/**
 * Status code (414) indicating that the server is refusing to service the request because the
 * <code><em>Request-URI</em></code> is longer than the server is willing to interpret.
 */
int SC_REQUEST_URI_TOO_LONG = 414;

/**
 * Status code (415) indicating that the server is refusing to service the request because the entity of the request
 * is in a format not supported by the requested resource for the requested method.
 */
int SC_UNSUPPORTED_MEDIA_TYPE = 415;

/**
 * Status code (416) indicating that the server cannot serve the requested byte range.
 */
int SC_REQUESTED_RANGE_NOT_SATISFIABLE = 416;

/**
 * Status code (417) indicating that the server could not meet the expectation given in the Expect request header.
 */
int SC_EXPECTATION_FAILED = 417;

/**
 * Status code (500) indicating an error inside the HTTP server which prevented it from fulfilling the request.
 */
int SC_INTERNAL_SERVER_ERROR = 500;

/**
 * Status code (501) indicating the HTTP server does not support the functionality needed to fulfill the request.
 */
int SC_NOT_IMPLEMENTED = 501;

/**
 * Status code (502) indicating that the HTTP server received an invalid response from a server it consulted when
 * acting as a proxy or gateway.
 */
int SC_BAD_GATEWAY = 502;

/**
 * Status code (503) indicating that the HTTP server is temporarily overloaded, and unable to handle the request.
 */
int SC_SERVICE_UNAVAILABLE = 503;

/**
 * Status code (504) indicating that the server did not receive a timely response from the upstream server while
 * acting as a gateway or proxy.
 */
int SC_GATEWAY_TIMEOUT = 504;

/**
 * Status code (505) indicating that the server does not support or refuses to support the HTTP protocol version
 * that was used in the request message.
 */
int SC_HTTP_VERSION_NOT_SUPPORTED = 505;