Rest API에 적합 + Micro Service에 적합
gateway를 사용하는 App은 다양한 API를 사용하며, 이는 Micro Service를 활용한 개발이라고 볼 수 있다.
API 설계, 명세, 테스트, 빌드를 할 수 있다.
API 문서를 보고 API 동작을 테스트하는데 특화되어있다.
Swagger Hub에서 UI를 직접 만들지 않고, Swagger UI를 사용하면 된다.
Swagger Hub를 이용하지 않고, 자체적인 서버에서 Swagger 모듈을 탑재해 API 명세가 가능하다.
특정한 서버프로그래밍 언어를 활용해 Swagger API를 종속적으로 사용한다 (특히 Spring의 anotation을 활용한 API명세)
API 문서 자동화
서버프로그래밍을 거치지 않고, Swagger를 별도의 웹문서로 완전히 빼내어 독립적으로 사용한다. (yaml파일을 작성하여 API 명세하는 방법)
API 수동 작성?
API를 직접 Control하는 백앤드가 아니라 Admin과 Portal에서 확인하고 관리할 뿐이기 때문에,
Yaml 파일을 보고, UI로 바로 보여주는 Swagger가 적합하다고 생각한다.
추측, Swagger를 사용해 보여준 걸 알아서 그런걸 수도 있다.
Swagger Codegen : 서버와 클라이언트에 Swagger로 설계된 API 코드를 생성하는
도구