swagger
Swagger 계약 상태
실제 호출자가 이해해야 하는 요청, 응답, 인증, 실패 케이스를 함께 문서화합니다.
request
요청 DTO
필드 설명, 예시 값, optional 여부를 호출자 관점으로 적습니다.
response
응답 모델
성공 응답의 실제 shape와 pagination/meta 구조를 명확히 합니다.
auth
인증
Bearer token, role, guard 조건을 엔드포인트별로 표시합니다.
error
오류 예시
400, 401, 404, 409처럼 자주 만나는 실패 응답을 남깁니다.