Swagger란?

API 설계, 구축, 문서화, 테스트 하는 과정을 돕는 프레임워크

주로 API 명세서를 작성하는데 사용 (PostMan도 가능)

API Spec 설계하기

YAML, JSOn 형식의 API 스펙을 작성한 후, 작성된 스펙을 기반으로 웹 페이지 형태로 문서화를 시켜준다.

Express에서 Swagger 사용 예시

1. 주석으로 Router 위에 작성해주기

• 코드 자체가 굉장히 불편하고 길어진다.

1. Swagger 함수를 통해 작성해주기

• Router에서 분리해서 작성할 수 있지만, 이 친구도 굉장히 길다는 단점이 존재