使用单个C # ASP.NET核心应用程序在不同的URL上提供多个Swagger用户界面

Question

我需要在单个C # ASP.NET核心应用程序上提供多个swagger UIs。这是必要的，因为应用程序API由用于UI和其他内容的内部“私有”API和可以被其他应用程序和用户访问的“公共”API组成。

每个Swaggerendpoint都应该在自己的Swagger UI页面上，并具有不同的URL地址。我能够在＜code＞启动时使用此代码将现有API规范划分为两个不同的json文件，并将json文件划分为不同的路径。cs配置方法：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{ 
    ...

    app.UseSwagger()
    app.UseSwaggerUI(c =>
            {
                c.SwaggerEndpoint("v0.1_public/swagger.json",  "Public API v0.1");
                c.SwaggerEndpoint("v0.1_private/swagger.json", "Private API v0.1");
            });
    ...
}

我通过在＜code＞Startup.cs＜code＞中过滤和添加两个摆动发生器来划分规范：

public void ConfigureServices(IServiceCollection services)
{
     ...
     services.AddSwaggerGen(c =>
        {
            c.DocumentFilter<PublicAPISwaggerFilter>();
            c.SwaggerDoc("v0.1_public", new OpenApiInfo
            {
                Title = "Public API",
                Version = "v0.1"
            });
        });
     services.AddSwaggerGen(c =>
        {
            c.DocumentFilter<PrivateApiSwaggerFilter>();
            c.SwaggerDoc("v0.1_private", new OpenApiInfo
            {
                Title = "Private API",
                Version = "v0.1"
            });
        });
     ...
}

然后在＜code＞上提供Swagger UIhttps://localhost:port/swagger两个endpoint都列在下拉菜单中。

当另一个位于路由上时，我如何创建两个 swagger UI，而另一个是

Answer 1

您需要将私有和公共控制器拆分为单独的应用程序。这样做也是有益的，因为您不想将公开访问的API与内部API混合。以这种方式维护将更容易。

如果它是您所遵循的特定URL约定，则可以由IIS或您用于托管应用程序的其他工具来处理。