Express REST API는 파싱, 매칭, 처리, 응답 계약으로 끝난다
REST 구현은 URL 이름보다 요청이 어떤 미들웨어와 핸들러를 지나 어떤 상태 코드와 JSON으로 끝나는지가 핵심이다.
| 구간 | 역할 | 확인할 값 | 좋은 기준 |
|---|---|---|---|
| Parse | 요청 본문을 JSON으로 파싱 | express.json() | body가 handler에서 읽힘 |
| Match | method와 path로 라우트 선택 | GET/POST/PUT/DELETE | 자원 행위와 메서드 일치 |
| Validate | params와 body를 검증 | id, required field, type | 초입에서 실패 응답 |
| Handle | 데이터 조회·수정 수행 | service, memory, DB | 로직과 응답 생성 분리 |
| Respond | 상태 코드와 JSON 반환 | 200, 201, 400, 404, 500 | 성공/실패 구조 일관 |
REST API는 요청 본문, 라우트, handler, 상태 코드가 같은 계약으로 연결되어야 유지보수가 쉽다.