사용법
- 검색창에 코드(예: 404)나 키워드(예: 인증, timeout)를 입력해 원하는 상태 코드를 찾습니다.
- 분류 버튼(1xx~5xx)으로 특정 그룹만 모아 볼 수 있습니다.
- 코드 항목을 클릭하면 코드 번호가 클립보드에 복사됩니다.
활용 팁
- API 디버깅에: 응답 코드를 받았을 때 의미가 헷갈리면 바로 검색해 확인하세요. 4xx는 요청 쪽, 5xx는 서버 쪽 문제라는 큰 줄기를 기억하면 원인 파악이 빨라집니다.
- 올바른 코드 설계: API를 만들 때 성공은 200/201, 잘못된 입력은 400, 인증 필요는 401, 권한 없음은 403, 없는 자원은 404처럼 의미에 맞는 코드를 돌려주면 사용하는 쪽이 동작을 예측하기 쉽습니다.
- 429와 503 구분: 요청이 너무 많아 막힌 것은 429(Too Many Requests), 서버가 일시적으로 불가한 것은 503(Service Unavailable)입니다. 재시도 전략을 다르게 가져가야 합니다.
자주 묻는 질문
Q. 상태 코드 앞자리 숫자는 무엇을 뜻하나요?
첫 자리로 응답의 종류를 구분합니다. 1xx는 정보(처리 중), 2xx는 성공, 3xx는 리다이렉션(추가 동작 필요), 4xx는 클라이언트 오류(요청이 잘못됨), 5xx는 서버 오류(서버가 요청을 처리하지 못함)를 뜻합니다. 분류 버튼으로 각 그룹만 모아 볼 수 있습니다.
Q. 401과 403은 어떻게 다른가요?
401 Unauthorized는 인증이 안 된 상태로, 로그인이나 올바른 인증 정보가 필요하다는 뜻입니다. 403 Forbidden은 인증은 됐지만 해당 자원에 접근할 권한이 없다는 뜻입니다. 간단히 말해 401은 '누구인지 모르겠다', 403은 '누구인지 알지만 허용되지 않는다'입니다.
Q. 여기 없는 코드나 비표준 코드도 있나요?
이 치트시트는 표준(RFC) 및 널리 쓰이는 주요 상태 코드를 담고 있습니다. 일부 서버나 CDN은 자체적인 비표준 코드(예: 일부 4xx·5xx 확장)를 쓰기도 하는데, 그런 코드는 해당 서비스 문서를 확인해야 합니다. 표준 코드의 의미를 빠르게 떠올리는 용도로 활용하세요.