HTTP 메서드 레퍼런스
HTTP 메서드(또는 “동사”)는 요청이 서버에서 어떤 동작을 하려는지 알려줍니다. 표의 두 속성은 API 설계 시 중요합니다:
- 안전(Safe) — 서버 상태를 바꾸지 않음(읽기 전용).
- 멱등(Idempotent) — 요청을 반복해도 한 번 한 것과 효과가 같음.
업데이트 2026-07-06
| 메서드 | 용도 | 안전 | 멱등 |
|---|---|---|---|
| GET | 리소스 조회; 부작용이 없어야 함 | 예 | 예 |
| HEAD | GET과 같지만 본문 없이 헤더만 반환 | 예 | 예 |
| POST | 리소스 생성 또는 처리를 위한 데이터 제출 | 아니요 | 아니요 |
| PUT | 요청 본문으로 리소스를 통째로 교체 | 아니요 | 예 |
| PATCH | 리소스에 부분 업데이트 적용 | 아니요 | 아니요 |
| DELETE | 리소스 삭제 | 아니요 | 예 |
| OPTIONS | 허용되는 메서드/헤더 질의(CORS preflight) | 예 | 예 |
| CONNECT | 서버로의 터널 수립(프록시가 사용) | 아니요 | 아니요 |
| TRACE | 받은 요청을 되돌려줌(진단용; 대개 비활성) | 예 | 예 |
관련 도구