HTTP 상태 코드 조회

HTTP 상태 코드 조회이란?

이 계산기를 사용해야 할 때

• 요청이 실패하고 상태 코드가 실제로 무엇을 의미하는지 이해해야 하는 API 통합을 디버깅
• Deciding which HTTP status code to return from your own API for a specific error condition
• Teaching or learning HTTP fundamentals in a web development course or bootcamp
• Writing error-handling middleware that needs to distinguish between different 4xx and 5xx cases
• Investigating why a redirect isn't working by checking whether 301 or 302 was returned
• Troubleshooting CORS issues where the browser shows a network error but the server returned 200

단계:

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

공식

사용 사례

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

주요 이점

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

전문가 팁

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

피해야 할 일반적인 실수

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

주요 용어 설명

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

관련 개념

• [object Object]
• [object Object]
• [object Object]
• [object Object]
• [object Object]

예시

결과 해석 방법