API 오류 추적
401, 403, 409, 422 같은 코드를 만났을 때 뜻과 흔한 맥락을 빠르게 찾습니다.
Guide
HTTP 상태 코드 페이지는 앱에 내장된 참조표로, 상태 코드 번호·영문 이름·한국어 뜻·설명으로 검색할 수 있고 1xx 정보, 2xx 성공, 3xx 리다이렉션, 4xx 클라이언트 오류, 5xx 서버 오류로 걸러 볼 수 있습니다. 보여 주는 것은 정적 지식이며, 입력한 도메인이나 API로 HTTP 요청을 보내지 않습니다.
2026-09-10 업데이트1 min read
404, “타임아웃”, 상태 이름 같은 키워드를 넣거나, 비워 둔 채 전체를 훑어봅니다.| 입력 | 출력 | 설명 |
|---|---|---|
404 |
404 Not Found 설명 | 번호 정확 검색 |
| “리다이렉션” | 관련 3xx 설명 매칭 | 텍스트 검색 |
| 5xx 선택 | 서버 오류 범주만 | 로컬 필터 |
HTTP_STATUS 목록에서 오며, 범위는 앱 버전에 따라 갱신될 뿐 IANA 등록부와 온라인 동기화되지 않습니다.fetch도 하지 않으므로, 특정 사이트가 지금 어떤 상태 코드를 돌려주는지 알려 줄 수 없습니다.401, 403, 409, 422 같은 코드를 만났을 때 뜻과 흔한 맥락을 빠르게 찾습니다.
2xx/3xx/4xx/5xx로 묶어 훑으면서 프로토콜의 기본 개념을 잡습니다.
아니요. 이 페이지에는 네트워크 요청 기능이 전혀 없고 로컬 상태 코드 표만 조회합니다.
아닙니다. 앱 배포와 함께 들어가는 내장 데이터입니다.
검색 키워드는 로컬에서 정적 표를 거를 뿐이며, 페이지는 어떤 HTTP 요청도 바깥으로 보내지 않습니다.
2026-09-10 업데이트
1xx–5xx 전체 상태 코드를 의미와 사용 사례와 함께 빠르게 찾아봅니다
이 도구는 아직 완전히 번역되지 않아 일부 내용이 원문 또는 대체 언어로 표시됩니다.
서버가 요청 헤더를 받았고 클라이언트는 본문 전송을 계속해야 합니다. 대용량 파일 업로드 전 확인(Expect: 100-continue)에 주로 사용됩니다.
서버가 프로토콜 전환에 동의한 상태이며, 주로 WebSocket 핸드셰이크(Upgrade: websocket)에서 사용됩니다.
WebDAV 확장: 요청을 받아 처리 중이지만 아직 응답이 없습니다. 클라이언트의 시간 초과를 방지합니다.
최종 응답 전에 일부 헤더를 먼저 반환하며, 주로 Link 헤더와 함께 브라우저가 CSS/JS 리소스를 미리 로드하도록 합니다.
요청이 성공했습니다. GET은 리소스 내용을, POST는 처리 결과를 반환합니다. 가장 흔한 상태 코드입니다.
리소스가 생성되었습니다. POST/PUT로 레코드를 만든 뒤 반환되며, 보통 Location 헤더로 새 리소스를 가리킵니다.
요청이 접수되었지만 아직 처리되지 않았습니다. 대기열 처리, 대량 가져오기 같은 비동기 작업에 적합합니다.
반환된 메타 정보는 로컬 또는 제3자 복사본(프록시가 수정한 경우 등)에서 온 것이며 원본 서버의 정식 버전이 아닙니다.
처리는 성공했지만 응답 내용이 없습니다. DELETE 성공 후나 페이지 이동 없이 폼을 저장한 경우에 흔합니다.
처리는 성공했으며 클라이언트가 화면을 초기화(폼 비우기 등)해야 합니다. 실제로는 거의 사용되지 않습니다.
범위 요청이 성공하여 리소스의 일부를 반환합니다. 동영상 탐색 재생과 이어받기 다운로드가 여기에 의존합니다(Range 헤더).
WebDAV 확장: 하나의 요청에 여러 작업이 포함되며, XML 본문에 각각의 상태가 따로 표시됩니다.
WebDAV 확장: 바인딩된 멤버가 이전 응답에서 이미 열거되었으므로 다시 나열하지 않습니다.
서버가 리소스에 대한 GET 요청을 완료했고, 응답은 인스턴스 조작(델타 인코딩)을 적용한 결과입니다.
리소스에 여러 표현(다국어 버전 등)이 있어 클라이언트나 사용자가 하나를 선택해야 합니다.
리소스가 새 주소로 영구 이전되었고 검색 엔진도 색인을 갱신합니다. 도메인 변경이나 HTTP에서 HTTPS로의 전환에 자주 사용됩니다.
리소스가 일시적으로 다른 주소에 있습니다. 예전 구현에서는 클라이언트가 POST를 GET으로 바꿀 수 있으므로 메서드를 유지해야 하면 307을 사용합니다.
클라이언트가 다른 주소에 GET으로 접근해 결과를 가져옵니다. 폼 제출 후 결과 페이지로 이동하는 PRG 패턴에 주로 사용됩니다.
마지막 요청 이후 리소스가 변경되지 않아 로컬 캐시를 계속 사용할 수 있습니다. ETag / Last-Modified와 함께 사용합니다.
(사용 중단) 지정한 프록시를 통해 리소스에 접근해야 합니다. 보안상의 이유로 최신 브라우저는 지원하지 않습니다.
302와 비슷하지만 리디렉션 시 요청 메서드와 본문을 바꾸면 안 됩니다(POST는 POST로 유지).
301과 비슷하지만 리디렉션 시에도 요청 메서드와 본문이 유지됩니다. API의 영구 이전에 적합합니다.
서버가 요청을 이해할 수 없습니다. 매개변수 누락, JSON 형식 오류, 잘못된 구문 등이 원인입니다. 클라이언트가 요청 내용을 확인해야 합니다.
자격 증명이 없거나 유효하지 않습니다(토큰 만료 등). 의미상 '로그인되지 않음'이며 사용자를 인증으로 유도해야 합니다.
예약된 상태 코드로, 일부 API가 할당량 소진이나 유료 구독 필요를 알릴 때 사용합니다.
신원은 확인되었지만 해당 리소스에 접근할 권한이 없습니다(일반 사용자가 관리자 인터페이스에 접근하는 경우 등). 401과의 차이는 인증과 권한 부여입니다.
요청한 리소스가 존재하지 않습니다. URL 오류 또는 리소스 삭제가 원인입니다. 가장 널리 알려진 상태 코드입니다.
리소스가 이 HTTP 메서드를 지원하지 않습니다(읽기 전용 인터페이스에 POST를 보내는 경우 등). 응답의 Allow 헤더에 허용된 메서드가 나열됩니다.
Accept 헤더 요구 사항을 충족하는 형식을 만들 수 없습니다(클라이언트는 XML만, 서버는 JSON만 있는 경우 등).
401과 비슷하지만 먼저 프록시 서버 인증이 필요합니다.
요청 전송 완료를 기다리다 서버가 시간 초과되었습니다(네트워크 지연 또는 클라이언트 중단). 클라이언트는 나중에 다시 시도할 수 있습니다.
요청이 리소스의 현재 상태와 충돌합니다. 같은 이름의 리소스 중복 생성, 동시 편집 등이 원인입니다.
리소스가 존재했지만 영구 삭제되어 복구되지 않습니다. 404보다 명확하며 검색 엔진이 색인에서 제거하는 데 도움이 됩니다.
서버가 요청에 Content-Length 헤더를 포함하도록 요구합니다.
If-Match 같은 조건부 헤더 조건이 충족되지 않았습니다. 낙관적 잠금에 쓰이며, 다른 사람이 수정한 리소스 덮어쓰기를 막습니다.
요청 본문이 서버 제한을 초과했습니다. 너무 큰 파일 업로드에서 흔합니다(nginx의 client_max_body_size 등).
요청한 URL이 서버가 처리할 수 있는 길이를 초과했습니다. GET 매개변수가 너무 많을 때 흔하며, POST로 바꾸는 것이 좋습니다.
요청 본문 형식이 지원되지 않습니다. application/json을 요구하는 API에 폼 형식을 보낸 경우 등입니다.
Range 헤더로 요청한 범위가 리소스의 실제 크기를 벗어났습니다. 이어받기 다운로드의 로컬 기록과 서버 파일이 다를 때 흔합니다.
Expect 헤더의 요구를 충족할 수 없습니다(100-continue 미지원 등).
1998년 만우절 장난(HTCPCP 프로토콜)으로, 찻주전자가 커피 추출을 거부한다는 의미입니다. 일부 사이트는 재미있는 크롤러 방지 응답으로 사용합니다.
응답을 생성할 수 없는 서버로 요청이 전달되었습니다. HTTP/2 연결 재사용으로 잘못된 가상 호스트에 도달할 때 흔합니다.
구문은 올바르지만 의미가 유효하지 않습니다. 필드 검증 실패(이메일 형식 오류 등)이며 REST API가 폼 검증 오류에 자주 사용합니다.
WebDAV 확장: 리소스가 잠겨 있어 현재 작업을 실행할 수 없습니다.
WebDAV 확장: 이전 요청이 실패했기 때문에 현재 요청도 완료할 수 없습니다.
재전송될 수 있는 초기 데이터(TLS 1.3 0-RTT) 처리를 서버가 거부하여 재전송 공격을 방지합니다.
현재 프로토콜로 처리를 거부하고 클라이언트에 업그레이드를 요구합니다. 응답의 Upgrade 헤더가 대상 프로토콜을 나타냅니다.
서버가 조건부 헤더(If-Match 등)를 요구하여 클라이언트가 낙관적 잠금을 사용하도록 하고 갱신 손실을 막습니다.
요청 제한에 도달했습니다. 응답의 Retry-After 헤더로 언제 다시 시도할 수 있는지 알릴 수 있으며, API 속도 제한의 표준 코드입니다.
요청 헤더 전체 크기 또는 개별 헤더 필드가 제한을 초과했습니다. 쿠키가 너무 커졌을 때 흔합니다.
저작권이나 규제 차단 등 법적 사유로 리소스 제공을 거부합니다. 번호는 소설 '화씨 451'에서 따왔습니다.
처리 중 예기치 않은 오류가 발생했습니다(처리되지 않은 예외, 코드 버그 등). 서버 로그를 확인해야 합니다.
서버가 이 요청 메서드나 기능을 지원하지 않습니다(GET/POST만 지원하는 서버에 PATCH 전송 등).
게이트웨이나 리버스 프록시가 업스트림 서버에서 유효하지 않은 응답을 받았습니다. 백엔드 다운이나 nginx 업스트림 연결 거부 시 흔합니다.
서버가 일시적으로 과부하 상태이거나 점검 중입니다. Retry-After 헤더를 함께 사용할 수 있습니다. 확장, 배포, 서킷 브레이커 상황에서 흔합니다.
게이트웨이나 프록시가 업스트림 서버 응답을 기다리다 시간 초과되었습니다. 백엔드 처리 지연이나 데이터베이스 슬로우 쿼리가 원인입니다.
서버가 요청에 사용된 HTTP 버전을 지원하지 않습니다.
콘텐츠 협상 설정 오류입니다. 선택된 변형이 다시 협상에 참여해 순환이 생깁니다.
WebDAV 확장: 요청에 필요한 내용을 저장할 공간이 서버에 부족합니다(디스크 가득 참 등).
WebDAV 확장: 요청 처리 중 무한 루프가 감지되었습니다(바인딩 관계의 순환 등).
요청에 서버가 요구하는 확장 정보가 없습니다. 확장한 뒤 다시 시도해야 합니다(거의 사용되지 않음).
네트워크 계층 인증을 거쳐야 인터넷을 사용할 수 있습니다. 호텔이나 공항 Wi-Fi의 캡티브 포털이 대표적인 예입니다.