Resource Design

REST API 일관성 기준

Nest 컨트롤러로 엔드포인트를 만들 때 HTTP 표준 의미를 유지하면 클라이언트 계약과 문서화가 쉬워집니다.

자원 이름

명사형 URI

/users, /posts처럼 처리 동작이 아니라 관리 대상 자원을 경로에 둡니다.

메서드 의미

HTTP 동사 사용

GET 조회, POST 생성, PATCH 부분 수정, DELETE 제거 의미를 일관되게 적용합니다.

상태 코드

결과 표현

201, 204, 400, 404처럼 클라이언트가 처리할 수 있는 응답 의미를 정확히 돌려줍니다.

표현 계약

DTO와 응답 형태

요청과 응답 구조를 DTO, serializer, Swagger 문서로 맞춰 변경 영향을 줄입니다.