개발

HTTP 상태 코드

모든 HTTP 상태 코드와 설명을 담은 참고 자료입니다. 기기에서 실행됩니다 — 업로드되지도, 저장되지도 않습니다.

전체 50개 중 50개 표시

100

계속

1xx

클라이언트는 요청을 계속 진행해도 됩니다. 요청의 앞부분이 수신되었음을 클라이언트에 알릴 때 사용합니다.

사용 사례: 서버가 요청의 일부를 수신했음을 알리며, 클라이언트는 계속 진행합니다.

101

프로토콜 전환

1xx

클라이언트의 요청에 따라 서버가 다른 프로토콜로 전환합니다.

사용 사례: HTTP에서 WebSocket으로 핸드셰이크 업그레이드.

102

처리 중

1xx

서버가 요청을 수신해 처리하고 있지만 아직 응답할 내용이 없습니다.

사용 사례: 오래 걸리는 WebDAV 요청에서 타임아웃 방지.

103

조기 힌트

1xx

최종 HTTP 메시지 전에 일부 응답 헤더를 먼저 보낼 때 사용합니다.

사용 사례: 전체 응답이 준비되기 전에 리소스를 미리 로드.

200

성공

2xx

요청이 성공했습니다. 구체적인 의미는 사용한 HTTP 메서드에 따라 다릅니다.

사용 사례: GET, POST, PUT, DELETE가 성공했을 때의 표준 응답.

201

생성됨

2xx

요청이 성공했고 그 결과로 새 리소스가 만들어졌습니다.

사용 사례: 새 사용자나 레코드를 성공적으로 만든 POST 요청.

202

접수됨

2xx

요청을 수신했지만 아직 처리하지는 않았습니다. 처리는 비동기로 진행됩니다.

사용 사례: API로 백그라운드 작업이나 비동기 작업을 실행할 때.

203

신뢰할 수 없는 정보

2xx

반환된 메타데이터가 원본 서버가 아니라 로컬 또는 서드파티 사본에서 온 것입니다.

사용 사례: 응답을 변환하거나 캐시하는 프록시 서버.

204

콘텐츠 없음

2xx

요청은 성공했지만 응답으로 보낼 콘텐츠가 없습니다.

사용 사례: 데이터를 반환할 필요가 없는 DELETE 또는 PUT.

206

부분 콘텐츠

2xx

클라이언트가 보낸 range 헤더에 따라 서버가 리소스의 일부만 전달합니다.

사용 사례: 동영상 스트리밍 또는 이어받기가 가능한 파일 다운로드.

207

다중 상태

2xx

WebDAV에서 여러 하위 요청에 대한 여러 상태 코드를 담습니다.

사용 사례: 여러 리소스의 상태를 함께 담은 WebDAV PROPFIND 응답.

208

이미 보고됨

2xx

DAV 바인딩의 구성원이 이전 응답에서 이미 열거되었습니다.

사용 사례: 구성원 정보의 반복을 피하는 WebDAV 응답.

226

IM 사용됨

2xx

서버가 GET 요청을 처리했으며 응답은 인스턴스 조작의 결과입니다.

사용 사례: HTTP 응답의 델타 인코딩.

301

영구 이동

3xx

요청한 리소스의 URL이 영구적으로 변경되었습니다. 새 URL은 응답에 담겨 있습니다.

사용 사례: 이전 URL에서 새 URL로 보내는 SEO 친화적 영구 리디렉션.

302

발견됨

3xx

요청한 리소스의 URL이 일시적으로 변경되었습니다. 이후 다시 바뀔 수 있습니다.

사용 사례: 페이지를 수정하는 동안 사용하는 임시 리디렉션.

303

다른 위치 보기

3xx

클라이언트가 다른 URI에서 GET 요청으로 리소스를 가져오도록 안내할 때 서버가 보내는 응답입니다.

사용 사례: POST 폼 제출 후의 리디렉션.

304

수정되지 않음

3xx

캐싱에 사용합니다. 응답이 변경되지 않았으므로 캐시된 버전을 사용해도 된다고 클라이언트에 알립니다.

사용 사례: ETag 또는 Last-Modified 헤더를 이용한 브라우저 캐시 검증.

307

임시 리디렉션

3xx

클라이언트가 같은 메서드로 다른 URI에서 리소스를 가져오도록 안내할 때 서버가 보내는 응답입니다.

사용 사례: 원래 HTTP 메서드를 유지하는 임시 리디렉션.

308

영구 리디렉션

3xx

원래 요청에 사용한 HTTP 메서드를 유지하는 영구 리디렉션입니다.

사용 사례: POST 메서드를 유지하는 영구 API 엔드포인트 이전.

400

잘못된 요청

4xx

구문이 잘못되었거나 요청 메시지 구성이 올바르지 않아 서버가 요청을 처리할 수 없습니다.

사용 사례: 올바르지 않은 JSON 본문 또는 필수 쿼리 파라미터 누락.

401

인증되지 않음

4xx

인증이 필요하지만 제공되지 않았거나 인증 정보가 올바르지 않습니다.

사용 사례: 유효한 토큰이나 세션 없이 보낸 API 요청.

402

결제 필요

4xx

향후 사용을 위해 예약된 코드이며, 간혹 전자 결제 요구에 사용됩니다.

사용 사례: 콘텐츠 이용에 결제나 구독이 필요한 경우.

403

금지됨

4xx

클라이언트에게 해당 콘텐츠에 대한 접근 권한이 없습니다. 401과 달리 신원은 확인된 상태입니다.

사용 사례: 인증된 사용자가 관리자 전용 리소스에 접근하려는 경우.

404

찾을 수 없음

4xx

서버가 요청한 리소스를 찾을 수 없습니다. 해당 URL을 인식하지 못합니다.

사용 사례: 존재하지 않는 페이지나 리소스에 접근하는 경우.

405

허용되지 않는 메서드

4xx

요청 메서드는 알고 있지만 대상 리소스에서는 지원하지 않습니다.

사용 사례: GET만 지원하는 엔드포인트에 DELETE를 보내는 경우.

406

받아들일 수 없음

4xx

요청 헤더에 지정된 허용 값 목록에 맞는 응답을 서버가 만들 수 없습니다.

사용 사례: API는 JSON만 반환하는데 클라이언트가 XML을 요구하는 경우.

408

요청 시간 초과

4xx

서버가 대기하려던 시간 안에 완전한 요청 메시지를 받지 못했습니다.

사용 사례: 클라이언트가 요청 본문을 보내는 데 너무 오래 걸리는 경우.

409

충돌

4xx

요청이 서버의 현재 상태와 충돌합니다.

사용 사례: 이미 존재하는 사용자 이름을 만들려는 경우.

410

사라짐

4xx

대상 리소스를 더 이상 사용할 수 없으며 앞으로도 제공되지 않습니다.

사용 사례: 대체 주소 없이 영구 삭제된 콘텐츠.

411

길이 필요

4xx

Content-Length 헤더 필드가 없어 서버가 요청을 거부했습니다.

사용 사례: Content-Length 헤더가 없는 POST 요청.

413

페이로드가 너무 큼

4xx

페이로드가 서버가 처리하려는 크기보다 커서 요청을 거부합니다.

사용 사례: 허용된 최대 크기를 초과한 파일 업로드.

414

URI가 너무 김

4xx

클라이언트가 요청한 URI가 서버가 해석하려는 길이보다 깁니다.

사용 사례: GET 요청의 지나치게 긴 쿼리 문자열.

415

지원하지 않는 미디어 타입

4xx

페이로드 형식을 지원하지 않아 서버가 요청을 받아들이지 않습니다.

사용 사례: JSON만 받는 API 엔드포인트에 XML을 보내는 경우.

422

처리할 수 없는 엔티티

4xx

서버가 콘텐츠 타입은 이해하지만 그 안의 내용을 처리할 수 없습니다.

사용 사례: JSON 형식은 올바르지만 필드 값이 잘못된 폼 데이터.

423

잠김

4xx

접근하려는 리소스가 잠겨 있습니다.

사용 사례: 다른 사용자가 잠근 WebDAV 리소스.

425

너무 이름

4xx

재전송될 수 있는 요청을 처리하는 위험을 서버가 감수하지 않겠다는 뜻입니다.

사용 사례: TLS 1.3 연결의 얼리 데이터.

429

요청이 너무 많음

4xx

사용자가 일정 시간 안에 너무 많은 요청을 보냈습니다 (요청 수 제한).

사용 사례: API 요청 한도 초과. 클라이언트는 요청 속도를 늦춰야 합니다.

431

요청 헤더 필드가 너무 큼

4xx

헤더 필드가 너무 커서 서버가 요청을 처리하지 않습니다.

사용 사례: 서버 제한을 초과한 쿠키 또는 사용자 지정 헤더.

451

법적 사유로 이용 불가

4xx

법적 요구에 따라 서버가 리소스 접근을 차단합니다.

사용 사례: DMCA 삭제 요청이나 법원 명령으로 차단된 콘텐츠.

500

내부 서버 오류

5xx

서버가 처리 방법을 알 수 없는 상황을 만났습니다.

사용 사례: 서버 측 코드에서 처리되지 않은 예외.

501

구현되지 않음

5xx

서버가 요청 메서드를 지원하지 않아 처리할 수 없습니다.

사용 사례: 서버가 해당 리소스에서 PATCH 메서드를 지원하지 않는 경우.

502

잘못된 게이트웨이

5xx

게이트웨이 역할을 하는 서버가 상위 서버로부터 올바르지 않은 응답을 받았습니다.

사용 사례: Nginx가 백엔드 앱 서버에서 잘못된 응답을 받는 경우.

503

서비스를 사용할 수 없음

5xx

서버가 요청을 처리할 준비가 되지 않았습니다. 점검 중이거나 과부하 상태인 경우가 많습니다.

사용 사례: 서버 점검 중이거나 트래픽이 몰린 경우.

504

게이트웨이 시간 초과

5xx

게이트웨이 역할을 하는 서버가 상위 서버로부터 제때 응답을 받지 못했습니다.

사용 사례: 상위 API의 응답이 너무 오래 걸리는 경우.

505

지원하지 않는 HTTP 버전

5xx

요청에 사용된 HTTP 버전을 서버가 지원하지 않습니다.

사용 사례: HTTP/1.1만 지원하는 서버에 클라이언트가 HTTP/3으로 요청하는 경우.

506

변형도 협상함

5xx

투명한 콘텐츠 협상 과정에서 서버 내부 설정에 오류가 있습니다.

사용 사례: 서버의 콘텐츠 협상 설정이 잘못된 경우.

507

저장 공간 부족

5xx

요청을 완료하는 데 필요한 표현을 서버가 저장할 수 없습니다.

사용 사례: 저장 공간이 부족한 WebDAV 서버.

508

루프 감지됨

5xx

요청을 처리하는 중에 서버가 무한 루프를 감지했습니다.

사용 사례: 순환 참조를 만드는 WebDAV 요청.

510

확장되지 않음

5xx

서버가 요청을 처리하려면 요청에 추가 확장이 필요합니다.

사용 사례: 클라이언트가 HTTP 확장 프레임워크 요청을 보내야 하는 경우.

511

네트워크 인증 필요

5xx

네트워크에 접속하려면 클라이언트가 인증해야 합니다.

사용 사례: 인터넷 사용 전에 로그인을 요구하는 캡티브 포털.