我们在使用Swagger的项目上使用Web 2。我的问题是,当应用Microsoft.AspNet.WebApi.Versioning时,如下所示:
Swagger UI忽略了一个事实,即现在我的API中有需要提供的版本。
我看了几个例子,但似乎没有一个能令人满意地解决这个问题。
如何强制Swagger允许我添加API版本,或者只是自动将版本号添加到URL中?
到目前为止的摇摆配置:
GlobalConfiguration.Configuration
.EnableSwagger(c =>
{
c.SingleApiVersion("v1", "MoovShack.ServerApi");
// If your API has multiple versions, use "MultipleApiVersions" instead of "SingleApiVersion".
// In this case, you must provide a lambda that tells Swashbuckle which actions should be
// included in the docs for a given API version. Like "SingleApiVersion", each call to "Version"
// returns an "Info" builder so you can provide additional metadata per API version.
//
//c.MultipleApiVersions(
// (apiDesc, targetApiVersion) => ResolveVersionSupportByRouteConstraint(apiDesc, targetApiVersion),
// (vc) =>
// {
// vc.Version("v2", "Swashbuckle Dummy API V2");
// vc.Version("v1", "Swashbuckle Dummy API V1");
// });
c.OperationFilter<MoovShackTokenHeaderParameter>();
})
.EnableSwaggerUi(c =>
{
// If your API has multiple versions and you've applied the MultipleApiVersions setting
// as described above, you can also enable a select box in the swagger-ui, that displays
// a discovery URL for each version. This provides a convenient way for users to browse documentation
// for different API versions.
//
//c.EnableDiscoveryUrlSelector();
});
您可以看到,到目前为止,MultipleApiVersions是禁用的-从一个很好的原因,因为它不会产生任何结果。特别是我不知道"ResolveVersionSupportByRouteConstraint“应该做什么。
我还读到了"EnableDiscoveryUrlSelector“有某种影响,但我也不确定这是否适用于我的情况。当我启用它时,什么都没发生。
发布于 2018-09-05 12:00:19
我们在我们的项目中像这样使用它,swagger识别它,它看起来很好。
[ApiVersion( "1.0" )]
[Route("api/v{version:apiVersion}/[controller]")]
public class SomeControlelr: Controller{
[HttpGet("", Name = "Someaction"), MapToApiVersion("1.0")]
public async Task<IActionResult> SomeAction(string someParameter)
https://stackoverflow.com/questions/47204257
复制相似问题