GET

리소스를 조회

데이터 조회

✅ 예 (같은 요청 여러 번 해도 결과 동일)

✅ 예 (서버 상태 변경 없음)

/users/1

POST

리소스를 생성

데이터 추가

❌ 아니오

❌ 아니오

/users

PUT

리소스를 전체 수정

데이터 전체 업데이트

✅ 예

❌ 아니오

/users/1

PATCH

리소스를 일부 수정

데이터 일부 업데이트

❌ 일반적으로 아니오 (서버 구현에 따라 다름)

❌ 아니오

/users/1

DELETE

리소스를 삭제

데이터 삭제

✅ 예 (이미 삭제된 경우에도 동일한 응답 가능)

❌ 아니오

/users/1

OPTIONS

지원하는 메서드 조회

CORS 사전 요청 등

✅ 예

✅ 예

/users

HEAD

리소스의 헤더만 조회 (본문 없음)

메타데이터 확인

✅ 예

✅ 예

/users/1

성공

(2xx)

200 OK

요청 성공

GET, PUT, PATCH, DELETE 등에 사용

데이터 조회 성공

201 Created

생성됨

POST 요청으로 리소스 생성 시 사용

회원가입, 글 작성 등

204 No Content

내용 없음

성공했지만 응답 본문이 없을 때

DELETE, PUT 성공 후 응답 없음

리다이렉션

(3xx)

301 Moved Permanently

영구 이동

리소스가 영구적으로 이동

URL 변경 안내

302 Found

임시 이동

리소스가 임시로 다른 위치에 있음

로그인 후 리디렉션

304 Not Modified

변경 없음

캐시된 리소스를 그대로 사용 가능

조건부 GET (If-Modified-Since 등)

클라이언트 오류

(4xx)

400 Bad Request

잘못된 요청

유효하지 않은 파라미터 등

필드 누락, JSON 파싱 실패

401 Unauthorized

인증 필요

로그인 필요 또는 토큰 오류

JWT 없음/만료

403 Forbidden

접근 금지

권한이 없는 경우

관리자 전용 접근

404 Not Found

리소스 없음

존재하지 않는 URI 요청

잘못된 ID로 조회 시

409 Conflict

충돌

중복 리소스 생성 시 등

동일 ID 중복 생성 등

422 Unprocessable Entity

처리할 수 없음

형식은 맞지만 의미가 잘못됨

폼 검증 실패 등

서버 오류

(5xx)

500 Internal Server Error

내부 서버 오류

서버 내부 예외 발생

예상치 못한 에러

502 Bad Gateway

게이트웨이 오류

서버가 잘못된 응답 수신

프록시, 게이트웨이 문제

503 Service Unavailable

서비스 불가

서버 점검 중 또는 과부하

서버 다운, 유지보수

504 Gateway Timeout

게이트웨이 타임아웃

응답 지연

백엔드 응답 지연 시