Cover image

HTTP QUERY 메서드와 API 조회 설계

HTTP QUERY method(RFC 10008)는 GET과 POST 사이의 빈칸을 메운다. 그렇다고 지금 모든 검색 API를 QUERY로 바꿀 이유는 없다. 이 메서드가 건드리는 것은 라우터보다 캐시 키, 재시도, 로그, WAF, CORS, 관측성의 합의에 가깝다. 본문이 있는 안전한 조회는 작은 약속이다. 그 약속을 중간 계층 전체가 같은 방식으로 지키게 만드는 일은 크다. HTTP QUERY method는 왜 GET body 논쟁을 끝내지 못하나 RFC 10008은 2026년 6월 IETF Proposed Standard로 발행됐다. 핵심은 단순하다. QUERY는 요청 본문(request content)을 받아 서버 쪽 조회를 실행하지만, 메서드 의미는 안전(safe)하고 멱등(idempotent)하다. 연결이 끊겨 클라이언트나 프록시가 같은 요청을 다시 보내도 상태 변경이 중복 실행되지 않아야 한다. ...

July 5, 2026 · 1274 words · gnosyslambda