Route Handler는 Web API 입력을 서버 계약으로 번역한다

Request를 한 번 해석하고 검증된 값만 서버 작업으로 보낸 뒤 명시적 Response로 끝낸다.

Request

URL · body · cookie

params id는 전용 parser로, JSON body는 unknown으로 한 번 읽음

Validate

형식·권한

parser가 만든 DTO만 통과시키고 잘못된 ID·본문은 400 반환

Execute

DB · cache · API

검증된 서버 값으로 실제 작업 수행

Response

JSON · redirect

status·header·cookie를 포함한 결과로 경계 종료

핵심성공·오류·이동 모두 Response 객체로 명시하면 호출자가 같은 계약으로 처리할 수 있다.