상태 코드 그룹
1xx 정보성
요청이 아직 진행 중입니다. 일반적인 브라우저 디버깅에서는 흔하지 않습니다.
2xx 성공
요청이 성공했습니다. 200, 201, 및 204 가장 자주 나타납니다.
3xx 리디렉션
클라이언트는 다른 URL을 따라가거나 캐시된 콘텐츠를 사용해야 합니다.
4xx 클라이언트 오류
요청이 유효하지 않거나 권한이 없거나 누락되었거나 요청 한도를 초과했습니다.
5xx 서버 오류
서버가 유효한 요청을 처리하는 중 실패했습니다.
실제로 자주 사용하는 코드
| 코드 | 의미 | 대표적인 경우 |
|---|---|---|
| 200 | OK | 정상적인 GET 또는 POST 성공 응답 |
| 201 | Created | POST 후 리소스가 성공적으로 생성되었습니다. |
| 301 | Moved Permanently | URL이 영구적으로 변경되었으므로 링크와 canonical 대상을 업데이트하세요. |
| 302 | Found | 임시 리디렉션, 주로 로그인 또는 단기 라우팅 |
| 400 | 잘못된 요청 | 잘못된 페이로드 또는 필수 매개변수 누락 |
| 401 | 인증되지 않음 | 인증 정보 누락 또는 유효하지 않음 |
| 403 | 접근 금지 | 인증되었지만 이 리소스에 접근할 수 없음 |
| 404 | 찾을 수 없음 | 경로, 파일 또는 리소스가 존재하지 않음 |
| 429 | 요청이 너무 많음 | 요청 한도 초과 |
| 500 | 내부 서버 오류 | 처리되지 않은 서버 측 실패 |
빠른 디버그 체크리스트
- 코드가 4xx라면 요청을 먼저 확인하세요: 인증, 페이로드 형식, URL, 헤더.
- 코드가 5xx이면 서버와 로그를 먼저 확인하세요.
- 코드가 301 또는 302이면 리디렉션 대상과 해당 동작이 의도된 것인지 확인하세요.
- 코드가 429이면 엔드포인트를 계속 호출하지 말고 재시도 로직이나 백오프를 추가하세요.
이 참고 자료를 적절한 도구와 함께 사용하세요
관련 도구