HTTP 메서드 — GET·POST·PUT·DELETE가 실제로 하는 일

게시일 2026-04-30수정일 2026-04-30

On this page

REST API 문서를 처음 열면 GET, POST, PUT, DELETE라는 단어가 나온다. 같은 URL이라도 어떤 메서드를 쓰느냐에 따라 완전히 다른 동작이 일어난다. AI 서비스 개발에서 이 구분을 모르면 API 설계부터 디버깅까지 헷갈린다.

정의

HTTP 메서드(HTTP Method)는 클라이언트가 서버에 요청할 때, 요청의 의도(동작 종류)를 명시하는 동사(Verb)다. 동일한 URL에 어떤 메서드를 사용하느냐에 따라 서버가 수행하는 동작이 달라진다.

RFC 9110에 표준화되어 있으며, rest API 설계의 기반이 된다.

핵심 메서드 4가지

GET — 읽기

용도: 서버의 데이터를 조회. 서버 상태를 변경하지 않음
특징: URL에 파라미터 포함 (?key=value). Body 없음. 브라우저 주소창 입력이 GET
예시: 게시글 목록 조회, AI 모델 목록 조회

GET /api/models HTTP/1.1
Host: api.anthropic.com
Authorization: Bearer sk-ant-...

POST — 생성

용도: 서버에 새 데이터 생성 또는 동작 트리거
특징: 요청 Body에 데이터 포함. 매번 새 리소스 생성
예시: 회원 가입, AI API 메시지 전송

POST /v1/messages
{ "model": "claude-sonnet-4-6", "messages": [...] }

PUT — 전체 수정

용도: 리소스 전체를 새 데이터로 교체
특징: 지정한 리소스의 모든 필드를 요청 Body로 덮어씀. 리소스가 없으면 생성하는 경우도 있음
예시: 프로필 정보 전체 수정

DELETE — 삭제

용도: 지정한 리소스 삭제
특징: Body 없이 URL만으로 대상 지정. 성공 시 204 No Content 반환
예시: 게시글 삭제, AI 대화 세션 종료

PATCH — 부분 수정

PUT의 형제 개념이지만 구분이 중요하다:

PUT: 리소스 전체를 교체 (모든 필드 필요)
PATCH: 일부 필드만 수정 (변경할 필드만 Body에 포함)

사용자 닉네임만 바꿀 때 PUT을 쓰면 다른 필드(이메일, 전화번호 등)가 모두 누락되어 초기화될 위험이 있다. 이때는 PATCH가 올바른 선택이다.

멱등성(Idempotency)

메서드의 중요한 특성 중 하나로, 같은 요청을 여러 번 해도 결과가 동일한 성질이다:

| 메서드 | 멱등성 | 이유 | |---|---|---| | GET | ✅ | 읽기만, 상태 변경 없음 | | PUT | ✅ | 같은 내용으로 덮어쓰기 | | DELETE | ✅ | 이미 삭제된 것 다시 삭제해도 결과 동일 | | POST | ❌ | 매번 새 리소스 생성 | | PATCH | ❌(조건부) | 구현에 따라 다름 |

AI API에서 POST /v1/messages를 두 번 보내면 AI 응답이 두 번 생성되고 과금도 두 번 발생한다. 네트워크 재시도 로직 구현 시 멱등성을 반드시 고려해야 하는 이유다.

AI API에서의 HTTP 메서드

llm API는 대부분 POST 중심으로 설계된다:

Anthropic: POST /v1/messages (대화 생성)
OpenAI: POST /v1/chat/completions (채팅 완성)
Hugging Face: POST /models/{model} (추론)

관리용 API(파인튜닝 작업 조회, 파일 삭제 등)에서는 GET, DELETE가 함께 사용된다.

활용 사례

REST API 설계: CRUD(Create/Read/Update/Delete) 동작을 POST/GET/PUT,PATCH/DELETE에 대응
프론트엔드 폼 처리: 회원 가입 = POST, 정보 수정 = PATCH, 탈퇴 = DELETE
AI 애플리케이션: 대화 생성 = POST, 히스토리 조회 = GET, 세션 삭제 = DELETE

정의