HTTP 상태 코드

HTTP 상태 코드 목록과 설명

1xx 부터 5xx 까지 59개 상태 코드를 번호나 영문 이름으로 검색하면 카테고리별로 묶여 한국어 설명과 함께 표시되고, 카테고리 필터로 4xx 만 골라 볼 수도 있습니다. 목록에는 WebDAV 의 102·207, 최근 도입된 103 Early Hints, 429 Too Many Requests, 451 처럼 교과서에 잘 없는 코드도 포함되어 있습니다. API 응답을 디버깅하는 개발자, 서버 로그의 코드 분포를 읽는 운영자, 면접 준비 중인 취업 준비생이 주로 찾습니다. 데이터가 페이지에 내장되어 인터넷 연결을 끊어도 동작합니다.

58개 결과 (전체 58개)

1xx 정보

100

Continue

서버가 요청의 일부를 받았으며 나머지를 계속 보내도 됩니다

101

Switching Protocols

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

102

Processing

서버가 요청을 처리 중이며 아직 응답이 없습니다 (WebDAV)

103

Early Hints

최종 응답 전에 일부 헤더를 미리 보냅니다

2xx 성공

200

요청이 성공적으로 처리되었습니다

201

Created

요청이 성공하여 새 리소스가 생성되었습니다

202

Accepted

요청이 접수되었으나 아직 처리되지 않았습니다

203

Non-Authoritative Information

메타 정보가 원본 서버의 것과 다를 수 있습니다

204

No Content

요청은 성공했으나 반환할 콘텐츠가 없습니다

205

Reset Content

클라이언트가 문서 뷰를 리셋해야 합니다

206

Partial Content

Range 헤더로 요청된 일부 콘텐츠만 반환합니다

207

Multi-Status

여러 리소스에 대한 상태 정보를 담고 있습니다 (WebDAV)

3xx 리다이렉션

300

Multiple Choices

요청에 대해 여러 응답이 가능합니다

301

Moved Permanently

리소스가 영구적으로 새 URI로 이동했습니다

302

Found

리소스가 일시적으로 다른 URI에 있습니다

303

See Other

GET을 사용해 다른 URI에서 리소스를 가져와야 합니다

304

Not Modified

캐시된 버전이 최신이므로 본문을 다시 보내지 않습니다

307

Temporary Redirect

다른 URI로 임시 리다이렉트하며 메서드를 유지합니다

308

Permanent Redirect

영구 리다이렉트하며 메서드를 유지합니다

4xx 클라이언트 오류

400

Bad Request

잘못된 문법으로 서버가 요청을 이해할 수 없습니다

401

Unauthorized

인증이 필요합니다

402

Payment Required

결제가 필요합니다 (미래 사용을 위해 예약)

403

Forbidden

권한이 없어 접근이 금지되었습니다

404

Not Found

요청한 리소스를 찾을 수 없습니다

405

Method Not Allowed

요청한 HTTP 메서드가 허용되지 않습니다

406

Not Acceptable

클라이언트의 Accept 헤더와 맞는 콘텐츠가 없습니다

407

Proxy Authentication Required

프록시 서버 인증이 필요합니다

408

Request Timeout

요청 시간이 초과되었습니다

409

Conflict

리소스의 현재 상태와 충돌이 발생했습니다

410

Gone

리소스가 영구적으로 삭제되어 더 이상 없습니다

411

Length Required

Content-Length 헤더가 필요합니다

412

Precondition Failed

헤더의 전제조건이 충족되지 않았습니다

413

Payload Too Large

요청 본문이 너무 큽니다

414

URI Too Long

요청 URI가 너무 깁니다

415

Unsupported Media Type

지원하지 않는 미디어 타입입니다

416

Range Not Satisfiable

요청한 Range가 리소스 범위를 벗어났습니다

417

Expectation Failed

Expect 헤더의 요구사항을 충족할 수 없습니다

418

I'm a teapot

서버는 커피가 아닌 차를 끓이는 주전자입니다 (April Fools)

421

Misdirected Request

요청이 응답할 수 없는 서버로 전달되었습니다

422

Unprocessable Entity

문법은 맞지만 의미상 처리할 수 없습니다 (WebDAV)

423

Locked

리소스가 잠겨 있습니다 (WebDAV)

425

Too Early

재전송 위험이 있는 요청을 서버가 처리하지 않습니다

426

Upgrade Required

클라이언트가 다른 프로토콜로 업그레이드해야 합니다

428

Precondition Required

요청에 전제조건(조건부 헤더)이 필요합니다

429

Too Many Requests

너무 많은 요청을 보냈습니다 (Rate Limiting)

431

Request Header Fields Too Large

요청 헤더 필드가 너무 큽니다

451

Unavailable For Legal Reasons

법적 이유로 접근할 수 없습니다

5xx 서버 오류

500

Internal Server Error

서버에서 처리 중 오류가 발생했습니다

501

Not Implemented

서버가 요청 메서드를 지원하지 않습니다

502

Bad Gateway

게이트웨이가 잘못된 응답을 받았습니다

503

Service Unavailable

서버가 일시적으로 사용할 수 없습니다

504

Gateway Timeout

게이트웨이 응답 시간이 초과되었습니다

505

HTTP Version Not Supported

요청한 HTTP 버전을 지원하지 않습니다

506

Variant Also Negotiates

콘텐츠 협상 설정에 내부 구성 오류가 있습니다

507

Insufficient Storage

서버 저장 공간이 부족합니다 (WebDAV)

508

Loop Detected

무한 루프가 감지되었습니다 (WebDAV)

510

Not Extended

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

511

Network Authentication Required

네트워크 인증이 필요합니다

HTTP Status, 이렇게 쓰세요

HTTP 상태 코드 전체를 번호·키워드로 검색해 의미, 흔한 원인, 대응 방법을 한국어로 보여 줍니다.

API 응답이 422·429·503 처럼 낯선 코드를 돌려줄 때, 리디렉션 코드(301 vs 308) 차이를 확인할 때 씁니다.

같은 4xx 라도 401 은 인증(로그인) 문제, 403 은 권한 문제입니다. 404 를 권한 오류에 쓰면 클라이언트 디버깅이 어려워집니다.

자주 묻는 질문

Q. 301 과 308 은 뭐가 다른가요?

둘 다 영구 리다이렉트지만 301 은 클라이언트가 POST 를 GET 으로 바꿀 수 있고, 308 은 메서드와 본문을 그대로 유지해야 합니다. API 엔드포인트 이전은 308 이 안전합니다.

Q. 422 는 400 대신 언제 쓰나요?

요청 형식은 올바르지만(JSON 파싱 성공) 값이 규칙에 어긋날 때 422 를 씁니다. 형식 자체가 깨졌으면 400 입니다. 다만 표준마다 해석이 달라 팀 규칙으로 정하는 편이 좋습니다.

Q. 429 응답을 받으면 어떻게 대응해야 하나요?

요청 빈도 제한에 걸린 것입니다. 응답의 Retry-After 헤더에 적힌 초만큼 기다린 뒤 재시도하고, 없으면 지수 백오프(1초, 2초, 4초...)로 간격을 늘리세요.