도입 계기 우리 회사의 경우, 하나의 서비스 아래에 여러가지 애플리케이션으로 나뉘어져 있습니다. (예, app, back office, gateway api 등등) API 문서를 확인하기 위해서는 각 애플리케이션의 도메인과 Swagger path를 알아야 하는 번거로움이 있었습니다.
여러가지 통합 방식 Swagger 문서를 통합하기 위해서는 여러가지 방식이 존재하는 것으로 알고 있습니다. 그 중에서도 간략히 정리를 해보자면, 1.
API Gateway 방식 `Spring Cloud Gateway`를 통해, 여러개의 마이크로서비스의 엔드포인트를 통합할 수 있어, 중앙 관리가 편리하다는 장점이 있습니다. 하지만, 별도의 관리 포인트가 늘어나 관리 부담이 증가할 수 있습니다. 2.
Swagger Aggregation 라이브러리 사용 독립 된 `Swagger UI` 서버를 실행하는 방식으로, 여러 언어로 개발 된 API 문서를 하나로 통합하기에 적합할 수 있습니다. 또, Swagger UI...
