Files
html-examples/doc/http/03_status_code.md
2025-01-24 01:44:03 +09:00

32 lines
2.5 KiB
Markdown

# 상태 코드
HTTP 응답 코드는 웹 서버가 클라이언트의 요청에 대해 어떻게 처리했는지를 알려주는 3자리 숫자 코드입니다. 이 코드는 요청의 성공 여부, 오류 발생 시 원인 등 다양한 정보를 담고 있어 웹 개발 과정에서 매우 중요한 역할을 합니다.
HTTP 응답 코드는 크게 다음과 같은 5가지 카테고리로 나눌 수 있습니다.
* 1xx (정보): 요청이 받아졌으며 처리가 계속되고 있음을 나타냅니다.
- 100 Continue: 서버가 요청을 받았으며, 클라이언트가 요청 본문을 보내도 된다는 의미입니다.
- 101 Switching Protocols: 프로토콜을 변경해야 한다는 의미입니다. (예: HTTP에서 WebSocket으로 전환)
* 2xx (성공): 요청이 성공적으로 처리되었음을 나타냅니다.
- 200 OK: 요청이 성공적으로 처리되었습니다.
- 201 Created: 새로운 자원이 생성되었습니다.
- 202 Accepted: 요청이 수락되었지만 아직 처리되지 않았습니다.
- 204 No Content: 요청은 성공했지만, 응답 본문에 내용이 없습니다.
* 3xx (리다이렉션): 요청을 완료하기 위해 추가적인 조치가 필요함을 나타냅니다.
- 301 Moved Permanently: 요청한 자원이 영구적으로 다른 URL로 이동했습니다.
- 302 Found: 요청한 자원이 임시로 다른 URL로 이동했습니다.
- 304 Not Modified: 요청한 자원이 변경되지 않았습니다.
- 307 Temporary Redirect: 302와 유사하지만, HTTP 메서드를 유지합니다.
* 4xx (클라이언트 오류): 클라이언트 측에서 오류가 발생했음을 나타냅니다.
- 400 Bad Request: 요청이 잘못되었습니다. (예: 잘못된 문법, 누락된 필드)
- 401 Unauthorized: 인증이 필요합니다.
- 403 Forbidden: 권한이 없습니다.
- 404 Not Found: 요청한 자원이 없습니다.
- 405 Method Not Allowed: 허용되지 않은 HTTP 메서드를 사용했습니다.
* 5xx (서버 오류): 서버 측에서 오류가 발생했음을 나타냅니다.
- 500 Internal Server Error: 서버에서 예상치 못한 오류가 발생했습니다.
- 502 Bad Gateway: 게이트웨이 또는 프록시 서버에서 잘못된 응답을 받았습니다.
- 503 Service Unavailable: 서버가 일시적으로 오버로드되거나 유지보수 중입니다.
- 504 Gateway Timeout: 게이트웨이 또는 프록시 서버가 타임아웃되었습니다.