OpenAPI

Swagger는 코드 옆 메타데이터를 API 계약으로 모은다

수동 문서는 코드와 어긋나기 쉽다. Nest Swagger는 DTO와 컨트롤러 데코레이터를 OpenAPI 명세와 Swagger UI로 연결한다.

DocumentBuilder

제목, 버전, 태그, 인증 스키마처럼 문서 전체 기준을 고정한다.

DTO Decorator

필드 설명, 예시, 제약 조건을 요청/응답 스키마로 드러낸다.

Controller

경로, HTTP 메서드, 응답 상태와 태그를 엔드포인트 계약으로 모은다.

Swagger UI

사람이 엔드포인트와 요청 예시를 읽고 테스트한다.

OpenAPI Spec

프론트엔드, 테스트, SDK 생성 도구가 같은 계약을 읽는다.

Try it out

문서 화면에서 요청을 보내 실제 API 계약을 검증한다.

검수 기준: 입력 구조, 응답 구조, 인증 방식이 실제 API 코드와 같은지 확인한다.