YalySeung

그냥 개발자

🔧 HTTP Method란?

정의

HTTP Method는 HTTP 요청이 수행하려는 작업의 종류를 나타낸다. 같은 URL이라도 메서드에 따라 조회, 생성, 수정, 삭제처럼 다른 의미를 가진다.

📌 주요 메서드

  • GET: 데이터 조회
  • POST: 데이터 생성 또는 처리 요청
  • PUT: 전체 수정
  • PATCH: 일부 수정
  • DELETE: 삭제

🧭 메서드별 특징

Method 의미 특징
GET 조회 서버 상태를 변경하지 않는 것이 원칙
POST 생성/처리 새 자원 생성이나 작업 요청에 사용
PUT 전체 수정 자원의 전체 내용을 교체하는 데 적합
PATCH 부분 수정 자원의 일부만 변경할 때 사용
DELETE 삭제 자원을 제거할 때 사용

포인트

REST API에서는 메서드만 봐도 이 요청이 어떤 의도인지 어느 정도 알 수 있어야 한다.

🧩 안전성과 멱등성

안전성

  • GET은 안전한 메서드로 본다.
  • 서버 상태를 바꾸지 않는 것이 원칙이다.

멱등성

  • GET, PUT, DELETE는 일반적으로 멱등성 기준에 맞는다고 본다.
  • POST는 보통 멱등성이 아니다.
  • PATCH는 구현 방식에 따라 달라질 수 있다.

[!important] 주의 조회 요청에 POST를 남용하면 API 의미가 흐려진다. 반대로 변경 작업을 GET으로 처리하면 캐시나 프리패치 때문에 문제가 생길 수 있다.

🛠️ 실무에서의 사용 기준

  • GET: 목록 조회, 상세 조회
  • POST: 등록, 로그인, 작업 요청
  • PUT: 전체 수정
  • PATCH: 일부 수정
  • DELETE: 삭제

⚠️ 주의할 점

  • 조회 요청에는 GET을 우선 사용한다.
  • 삭제나 수정은 의미가 분명한 메서드를 사용한다.
  • URL만 보고도 대략적인 동작을 유추할 수 있게 설계한다.
  • 브라우저 캐시나 프록시의 영향을 고려해야 한다.

🧾 정리

HTTP Method는 REST API의 의도를 드러내는 핵심 수단이다. 요청 목적에 맞는 메서드를 사용하면 API가 더 읽기 쉽고 유지보수하기 좋아진다.

연결문서

댓글남기기

참고