HTTP 상태 코드 조회

200, 404, 500 등 모든 HTTP 상태 코드를 조회하고, 그 의미와 서버가 언제 이를 반환하는지 쉬운 말로 확인하세요.

HTTP 상태 코드 조회이란?

HTTP 상태 코드는 웹 서버가 모든 응답과 함께 보내는 세 자리 숫자로, 요청이 성공했는지, 리디렉션이 필요한지, 실패했는지, 그리고 그 이유를 클라이언트(브라우저, 앱, API 소비자)에게 알려줍니다. IETF에 의해 표준화되어 모든 웹 서버, 브라우저, 프로그래밍 언어에서 동일하게 사용되며, 이 덕분에 소프트웨어 개발에서 가장 보편적인 디버깅 참고 자료 중 하나가 되었습니다.

이 조회 도구는 정보성(1xx), 성공(2xx), 리디렉션(3xx), 클라이언트 오류(4xx), 서버 오류(5xx) 등 다섯 범주 전반에서 가장 흔히 접하는 코드를 다루며, 형식적인 RFC 정의뿐 아니라 실제로 각 코드가 무엇을 의미하는지 쉬운 말로 설명합니다.

공식

1xx: 정보성 — 요청을 수신했으며 처리를 계속함

2xx: 성공 — 요청이 성공적으로 수신되고 수락됨

3xx: 리디렉션 — 요청을 완료하려면 추가 작업이 필요함

4xx: 클라이언트 오류 — 요청의 문법이 잘못되었거나 처리할 수 없음

5xx: 서버 오류 — 서버가 유효한 요청을 처리하지 못함

계산 방법

검색창에 상태 코드(예: 404) 또는 키워드(예: "forbidden")를 입력하세요.
특정 범위를 살펴보려면 1xx-5xx 버튼으로 범주별 필터링을 사용하세요.
각 코드가 무엇을 의미하고 언제 주로 반환되는지 쉬운 말 설명을 읽으세요.
API 응답을 디버깅하거나 오류 처리 로직을 만들 때 빠른 참고 자료로 활용하세요.

예시

"429"를 검색하면 "Too Many Requests"가 나옵니다 — API가 요청 제한을 초과했을 때 반환하는 코드로, 속도를 늦추고 지연 후 재시도하라는 의미입니다.

주요 이점

자주 쓰이는 모든 상태 코드를 하나의 검색 가능한 참고 자료로 제공
형식적인 RFC 문구가 아닌 쉬운 말 설명
범주(1xx부터 5xx까지)로 즉시 필터링
무료이며 빠르고 가입이 필요 없음

피해야 할 일반적인 실수

실제로 실패한 요청에 200 OK를 반환해 모니터링 도구로부터 오류를 숨김
401(인증되지 않음)과 403(인증되었으나 권한 없음)을 혼동
영구적이어야 할 리디렉션(301)에 302를 사용해 SEO에 손해를 끼침
클라이언트 측 오류 처리에서 모든 4xx, 5xx 오류를 특정 코드로 분기하지 않고 동일하게 취급

전문가 팁

5xx 코드는 엄격하게 서버 측 실패에만 사용하고, 클라이언트 입력 오류를 나타내는 데는 절대 사용하지 마세요
속도 제한 시 Retry-After 헤더와 함께 429를 사용해 잘 동작하는 클라이언트가 언제 재시도할지 알 수 있게 하세요
리소스가 실제로 존재하지 않을 때는 일반적인 오류 페이지 대신 404를 사용하는 것이 사용자와 검색 엔진 모두에 좋습니다
API를 설계할 때는 모든 것을 일반적인 400으로 처리하기보다 구체적인 4xx 코드(422, 409, 400)를 선택하세요

주요 용어 설명

상태 라인(Status line): 상태 코드와 짧은 사유 문구를 포함하는 HTTP 응답의 첫 줄
멱등성(Idempotent): 동일한 요청을 반복해도 한 번 실행한 것과 같은 효과를 내는 특정 HTTP 메서드의 속성
리디렉션 체인(Redirect chain): 브라우저가 최종 리소스에 도달하기 전에 따라가는 여러 리디렉션의 연속
속도 제한(Rate limiting): 특정 시간 창 내에 클라이언트가 보낼 수 있는 요청 수를 제한하며, 흔히 429로 신호를 보냄

일반적인 사용 사례

연동 중인 API가 반환한 낯선 상태 코드를 빠르게 이해
특정 오류 조건에 대해 자신의 API에서 어떤 상태 코드를 반환할지 결정
특정 코드가 실제로 무엇을 의미하는지 확인해 요청 실패 원인 디버깅
웹 개발 강의에서 HTTP 기초를 가르치거나 배우기
서로 다른 4xx, 5xx 상황을 구분하는 정확한 오류 처리 로직 작성

자주 묻는 질문

HTTP 상태 코드의 각 범위는 무엇을 의미하나요?

1xx는 정보성 코드, 2xx는 성공, 3xx는 리디렉션, 4xx는 클라이언트가 잘못된 요청을 보냈음(예: 없는 페이지 요청), 5xx는 유효한 요청을 서버 자체가 처리하지 못했음을 의미합니다.

401과 403의 차이는 무엇인가요?

401 Unauthorized는 인증되지 않았거나(또는 자격 증명이 유효하지 않음) 서버가 당신이 누구인지 모른다는 의미입니다. 403 Forbidden은 서버가 당신을 알고 있지만 해당 리소스에 접근할 권한이 없다는 의미입니다.

분명히 로드에 실패한 페이지에서 왜 200이 표시되나요?

이는 대개 서버가 유효한 HTTP 응답(따라서 200 OK)을 반환했지만, 그 응답의 애플리케이션 수준 내용이 오류를 설명하고 있다는 뜻입니다 — 오류 세부 정보를 상태 코드가 아니라 응답 본문에 담는 API에서 흔히 나타나는 패턴입니다.

301과 302 리디렉션의 차이는 무엇인가요?

301 Moved Permanently는 브라우저와 검색 엔진에 앞으로는 새 URL을 기록하고 사용하라고 알립니다. 302 Found는 임시 리디렉션을 나타내며 — 향후 요청에도 원래 URL을 계속 사용해야 합니다.

HTTP 상태 코드 조회