상태 코드는 하나의 언어예요
서버가 응답 코드로 뭐라고 말하는지 읽는 법을 배워요
⏱ 예상 ~5분
01 · 읽기
모든 HTTP 응답은 상태 코드 (status code) 로 시작해요. 서버의 첫 마디예요 — 본문을 읽기 전에요.
상태 코드는 첫 숫자로 분류돼요: - 2xx = 성공 (문제 없음) - 4xx = Client 오류 (너의 잘못) - 5xx = Server 오류 (그쪽 잘못)
이걸 알면 어떤 API 문제든 몇 초 안에 진단할 수 있어요.
핵심 정리
- 200 = OK — 요청 성공, 본문에 데이터 있음
- 401 = Unauthorized — 인증이 필요해요
- 403 = Forbidden — 인증은 됐지만 권한이 없어요
- 404 = Not Found — 그 경로가 존재하지 않아요
- 429 = Too Many Requests — 요청 제한에 걸렸어요
- 500 = Internal Server Error — 그쪽 버그, 너의 문제 아니에요
02 · 터미널 실습
일부러 오류를 일으키고 응답을 봐요. 상태 줄을 보려면 -i 를 써요. 먼저 존재하지 않는 path 로 요청해 봐요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
03 · 터미널 실습
이제 401 을 일으켜 봐요 — 인증이 필요한 보호된 엔드포인트예요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
04 · 터미널 실습
이제 500 — 이건 서버의 문제예요, 너의 문제 아니에요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
05 · 짝짓기
각 HTTP 상태 코드를 의미와 짝지어요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
06 · 퀴즈
API 를 호출했더니 HTTP/2 429 가 왔어요. 뭘 해야 하나요?
- 코드를 고쳐요 — 형식이 잘못된 요청을 보냈어요
- API 키를 확인해요 — 십중팔구 만료됐어요
- 잠시 기다렸다가 재시도해요 — 요청 제한에 걸렸어요
- 서버가 다운됐어요 — 다른 엔드포인트로 시도해요
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.