GET이 드디어 바디를 갖는다 — HTTP QUERY 메서드의 등장

오랫동안 개발자들은 검색·필터 같은 '읽기' 요청을 보낼 때 딜레마에 빠졌습니다. GET은 캐시 가능하고 안전(safe)하지만 본문(body)을 쓸 수 없어 긴 쿼리를 URL에 욱여넣어야 했고, URL 길이 제한과 로그에 민감정보가 남는 문제가 있었죠. 그렇다고 POST를 쓰면 본문은 자유롭지만 '안전하지 않은' 메서드로 취급돼 캐싱과 멱등성(idempotency) 이점을 잃었습니다.

RFC 10008이 표준화한 새로운 QUERY 메서드가 바로 이 빈틈을 메웁니다. QUERY는 GET처럼 안전하고 멱등하면서도 POST처럼 요청 본문을 가질 수 있습니다. 즉 복잡한 JSON 필터나 GraphQL 스타일 쿼리, 대용량 검색 조건을 본문에 담아 보내되, 서버는 이를 '읽기 전용'으로 안전하게 처리하고 응답을 캐싱할 수 있습니다.

핵심 인사이트는 '의미론(semantics)의 복원'입니다. 그동안 POST로 우회하던 검색 API가 이제 의도를 정확히 표현하는 메서드를 갖게 됐고, 프록시·CDN·게이트웨이가 요청 성격을 올바로 판단할 수 있습니다. API 설계자라면 검색 엔드포인트 설계 방식을 다시 검토할 때입니다.