Используйте Swashbuckle, чтобы получить один документ OpenAPI из нескольких проектов .NET Core.

Question

Есть ли способ получить один документ OpenAPI, содержащий все операции из нескольких базовых проектов .NET, используя Swashbuckle?

Контекст:

У нас есть несколько внешних проектов (созданных с помощью .NET Core).) но они семантически являются частью одного сервиса, для которого мы хотим иметь один документ OpenAPI.Поскольку Swashbuckle генерирует документ при запуске для каждого отдельного проекта, мы получаем несколько документов OpenAPI.

Есть ли обходной путь, чтобы эти операции отображались в одном документе?Судя по тому, как работает Swashbuckle, кажется, что это невозможно?Возможно, позже мы сможем объединить документы Swagger с другими библиотеками, но если Swashbuckle найдет способ поддержать это, мы бы предпочли это.

Answer 1

Возможно, вам нужно использовать api gateway.

На самом деле существует несколько коммерческих продуктов, которые предлагают эту услугу, например:

• Apigee
• Шлюз API AWS
• Управление API Azure

, но если вы не хотитеЧтобы использовать (и платить) за эти услуги, вы можете использовать альтернативу с открытым исходным кодом для .Net Core, такую ​​как Ocelot

С API Gateway вы сможетеобъединить несколько проектов API и управлять их использованием и распространением (например, политика безопасности, регулирование и т. д.).