我们正在升级我们的webapi,以便在我们的dotnet Core应用程序中启用OAS3.0,从文档中看,似乎只有SwashBuckle.Aspnetcore 5.4.1+版本才支持。正如这里提到的: https:/github.comdomaindrivendevSwashbuckle.AspNetCore。
所以我们把SwashBuckle.Aspenetcore升级到5.4.1。当我们运行这个应用程序的时候,虽然,它仍然会产生 swagger 2.0
而不是 OAS 3.01
. 现在,在同一页面上的文档并没有指定任何特别的东西,我们必须做,当你从 swagger2.0
-->OAS3.0
目前我的小配置如下。
app.UseSwaggerUI(c =>
{
c.SwaggerEndpoint("/myapp/swagger/v1/swagger.json", "API name");
c.RoutePrefix = "myapp/swagger";
c.DisplayRequestDuration();
c.DisplayOperationId();
});
页面上的文档还指向一个页面,在这里的链接中提到了对OAS3.0的支持。https:/swagger.iospecification
但同样没有代码可以参考。谁能告诉我如何将我的API从swagger 2.0升级到OAS 3.0的具体细节?
看起来你有 c.SerializeAsV2 = true
代码中的某个地方。要输出OpenAPI 3.0,这个选项必须是 false
.