Развертывание OpenAPI на локальном хосте

Question

В моей организации много API для разных проектов.Мне нужна реализация OpenAPI , которая позволяет мне создать автономный портал, который содержит все эти API (точнее, хранилище) для всех наших продуктов.

Существует ли OpenAPI , который поддерживает это?

Другой вариант: объединить несколько экземпляров в один экземпляр OpenAPI.

Answer 1

Существует несколько способов реализации каталогов API.

Swagger UI (с открытым исходным кодом)

Swagger UI 3.0.19+ может отображать несколько определений API с использованиемurl параметр.

// index.html

const ui = SwaggerUIBundle({
  dom_id: '#swagger-ui',
  urls: [
   {name: "petstore",  url: "http://petstore.swagger.io/v2/swagger.json"},
   {name: "instagram", url: "https://api.apis.guru/v2/specs/instagram.com/1.0.0/swagger.yaml"}
  ],
  "urls.primaryName": "petstore",  // default spec
  ...

Результат:

Поскольку Swagger UI является открытым исходным кодом, вы можете настроить его макет и внешний вид в соответствии с вашими потребностями.

SwaggerHub (коммерческий)

SwaggerHub предоставляет хостинг каталогов API для групп и организаций, как в облаке, так и локально.SwaggerHub также поддерживает разработку API, совместную работу, генерацию кода и интеграцию рабочих процессов.

Раскрытие информации: я работаю в компании, которая делает SwaggerHub.