REST 점검표

리소스 규칙을 끝까지 일관되게

REST API 설계는 URI 이름, HTTP 메서드, DTO 검증, 상태 코드가 같은 리소스 모델을 설명합니다.

URI

명사형 리소스

/users처럼 컬렉션을 명사로 표현하고 행위는 경로에 넣지 않습니다.

method

메서드로 행위 표현

조회는 GET, 생성은 POST, 부분 수정은 PATCH, 삭제는 DELETE로 나눕니다.

DTO

입력 모양 고정

ValidationPipe와 DTO로 잘못된 body를 서비스 로직 전에 차단합니다.

status

상태 코드 명확화

생성은 201, 삭제는 204, 찾지 못한 리소스는 404로 의도를 드러냅니다.

경계
Controller는 HTTP 해석, Service는 비즈니스 처리

라우트 매핑과 상태 코드는 컨트롤러에 두고, 실제 조회와 변경 규칙은 서비스에 모으면 테스트와 확장이 쉬워집니다.