새 메서드

HTTP QUERY

QUERY는 안전하고 멱등하면서 요청 본문을 전달하는 메서드입니다. 말하자면 “본문이 있는 GET”이죠. 복잡한 조회 조건을 비대해진 URL 대신 본문에 담을 수 있고, 조회에 어울리지 않는 POST를 억지로 쓰지 않아도 됩니다.

HTTP를 배우고, 시험하고, 검증하기 — 새로운 QUERY까지

/api/echo

→ request

QUERY /productsNEWAccept: application/jsonContent-Type: application/json { "category": "boots", "inStock": true}

← response

200 OKContent-Location: /products?…Cache-Control: max-age=60 { "results": 42, "cacheable": true}

동일한 상품 검색을 네 가지 방식으로:

좌우로 스와이프하여 모든 메서드를 비교하세요. QUERY가 먼저 표시됩니다.

특성	QUERY	GET · URL	GET · body	POST
요청 본문	JSON	없음	의미 미정의 · 지양	JSON
안전 (부수효과 없음)	✓	✓	✓	✗
멱등	✓	✓	✓	✗
응답 캐시 가능	✓Content-Location 통해	✓	~불확실 · 미정의	~기본 불가 · 명시 필요
필터가 URL에 들어가지 않음	✓	✗	✓	✓
URL 길이 제한 없음	✓	✗약 2KB 상한	✓	✓
표준화 및 지원	~새 RFC · 도입 초기	✓	✓	✓