Swashbuckle Swagger 要求 api 版本？

Question

我們已經實現了這里提到的 api 版本控制https://referbruv.com/blog/integrating-aspnet-core-api-versions-with-swagger-ui/

但是，當它應該知道它是版本 2 時，為什么我們會得到這個 api-version 字段？

我用以下內容裝飾了端點，但它仍然顯示此 api-version 字段？

[HttpGet("summary/all")]
[MapToApiVersion("1.0")]

我也對 v2 端點做了同樣的事情，但改為 2.0

Answer 1

添加ApiVersionReader似乎可以更正此問題：

services.AddApiVersioning(setup =>
{
    setup.AssumeDefaultVersionWhenUnspecified = true;
    setup.DefaultApiVersion = new ApiVersion(1, 0);
    setup.ReportApiVersions = true;
    setup.ApiVersionReader = ApiVersionReader.Combine(new UrlSegmentApiVersionReader(),
        new HeaderApiVersionReader("x-api-version"),
        new MediaTypeApiVersionReader("x-api-version"));
});

可以在這個問題Replacing app.UseMvc() with app.UserRouting() 中找到對我有用的完整示例，給我們錯誤“請求匹配多個端點”