빠르고 검색 가능한 HTTP 상태 코드 목록
브라우저, 모바일 앱 또는 검색 엔진 크롤러가 웹 서버에 요청을 보낼 때마다 서버는 세 자리 숫자로 응답합니다. 이러한 HTTP 상태 코드는 요청 성공, 실패, 인증 필요, 리디렉션 등 클라이언트에게 정확히 어떤 일이 발생했는지 알려줍니다.
이 도구는 공식 RFC 사양을 기반으로 표준 HTTP 응답 코드에 대한 완벽한 검색 사전을 제공합니다. 전체 목록이 브라우저 로컬에서 로드되고 필터링되므로 실시간으로 즉시 검색할 수 있습니다. 301과 302의 차이점을 확인하거나 422 에러의 의미를 알아보기 위해 페이지가 새로고침될 때까지 기다릴 필요가 없습니다.
HTTP 응답 코드의 5가지 분류
HTTP 코드는 첫 번째 숫자에 따라 5가지로 분류됩니다. 이 분류를 이해하면 웹 트래픽 문제를 가장 빠르게 진단할 수 있습니다:
1xx (정보 제공)
서버가 요청을 수신했으며 처리를 계속하고 있음을 나타냅니다. 임시 응답이므로 클라이언트는 최종 응답을 기다려야 합니다. 예를 들어, 100 Continue는 클라이언트에게 요청 본문을 계속 보내라는 의미입니다.
2xx (성공)
클라이언트의 요청을 성공적으로 수신, 이해 및 수락했음을 의미합니다. 가장 일반적인 코드는 성공적인 HTTP 요청의 표준 응답인 200 OK입니다. API로 새 레코드를 생성할 때는 주로 201 Created가 반환됩니다.
3xx (리다이렉션)
요청을 완료하려면 클라이언트의 추가 작업이 필요함을 나타냅니다. 주로 요청한 리소스가 이동되었음을 의미합니다. 301 Moved Permanently는 검색 엔진에 링크를 업데이트하도록 지시하며, 302 Found는 임시 이동을 의미합니다.
4xx (클라이언트 오류)
4xx 대역의 HTTP 오류 코드는 클라이언트 측에 문제가 있음을 의미합니다. 요청의 구문이 잘못되었거나, 인증이 부족하거나, 존재하지 않는 리소스를 요청했을 수 있습니다. 사용자가 URL을 잘못 입력하거나 API 연동 시 잘못된 형식의 데이터를 전송할 때 자주 발생합니다.
5xx (서버 오류)
서버가 유효한 요청을 처리하지 못했음을 의미합니다. 클라이언트의 요청은 올바르지만, 서버 내부에 문제가 발생했거나, 다운되었거나, 현재 과부하 상태일 때 발생합니다.
알아두어야 할 주요 HTTP 에러 코드
수십 개의 상태 코드가 있지만, 개발자나 웹마스터가 겪는 에러의 대부분은 다음 몇 가지로 압축됩니다:
404 상태 코드 (Not Found)
인터넷에서 가장 널리 알려진 이 에러는 서버가 요청한 리소스를 찾을 수 없음을 의미합니다. 깨진 링크는 사용자 경험을 해치고 크롤링 예산을 낭비하므로, 웹사이트 운영자라면 SEO를 위해 404 에러를 반드시 모니터링해야 합니다.
400 Bad Request
잘못된 요청 구문이나 유효하지 않은 라우팅 등 클라이언트 측의 오류로 인해 서버가 요청을 처리할 수 없는 상태입니다. API 호출 시 필수 파라미터가 누락된 경우 자주 발생합니다.
401 Unauthorized & 403 Forbidden
두 코드 모두 접근 권한과 관련이 있습니다. 401 Unauthorized는 요청을 처리하기 위해 클라이언트 인증이 필요함을 의미합니다(예: API 키 누락). 반면 403 Forbidden은 클라이언트의 신원은 확인되었으나, 해당 리소스에 접근할 권한이 없음을 뜻합니다.
500 Internal Server Error
서버 측 오류를 나타내는 가장 포괄적인 에러 코드입니다. 서버에 예기치 않은 문제가 발생하여 요청을 처리할 수 없음을 의미합니다. 500 에러가 발생하면 주로 서버의 애플리케이션 로그를 확인하여 근본 원인을 파악해야 합니다.
502 Bad Gateway & 503 Service Unavailable502 Bad Gateway는 프록시(Nginx, 로드 밸런서 등) 역할을 하는 서버가 업스트림 서버로부터 유효하지 않은 응답을 받았을 때 발생합니다. 503 Service Unavailable은 서버 과부하 또는 유지보수 등으로 인해 현재 요청을 처리할 수 없는 상태를 의미합니다.
API 개발 모범 사례
REST API를 개발할 때 올바른 HTTP 상태 코드를 반환하는 것은 훌륭한 개발자 경험을 제공하기 위해 필수적입니다. 오류가 발생했는데도 200 OK를 반환하면(흔히 오류를 "삼킨다"고 표현함) 클라이언트가 요청 성공 여부를 파악하기 위해 응답 본문을 직접 파싱해야 하는 불편함이 생깁니다.
이 레퍼런스를 참고하여 의미에 가장 잘 맞는 코드를 선택하세요. 예를 들어, 사용자가 요청 제한(Rate limit)을 초과했을 때는 429 Too Many Requests를, JSON 페이로드는 유효하지만 비즈니스 로직 검증에 실패했을 때는 422 Unprocessable Content를 사용하세요.
서버 라우팅 문제를 조사 중이라면, 도메인 레코드를 확인하는 DNS 조회 도구나 서버에 요청을 보내는 클라이언트를 분석하는 User-Agent 파서가 도움이 될 수 있습니다. 404 에러를 방지하고 검색 엔진의 사이트 크롤링 방식을 관리하고 싶다면 Robots.txt 생성기를 사용해 보세요.