Swagger - 隐藏 api 版本参数

Question

是否可以隐藏“api-version”和“x-api-version”参数？

        services.AddApiVersioning(config =>
        {
            config.ReportApiVersions = true;
            config.DefaultApiVersion = new ApiVersion(1, 0);
            config.AssumeDefaultVersionWhenUnspecified = true;

            config.ApiVersionReader = ApiVersionReader.Combine(
             new QueryStringApiVersionReader(),
             new HeaderApiVersionReader()
             {
                 HeaderNames = { "x-api-version" }
             });
        });

        services.AddVersionedApiExplorer(
            options =>
            {
                // note: the specified format code will format the version as "'v'major[.minor][-status]"
                options.GroupNameFormat = "'v'VVV";

                options.DefaultApiVersionParameterDescription = "Do NOT modify api-version!";
            });

我已经检查了实现“RemoveVersionFromParameter”方法的how-to-set-up-swashbuckle-vs-microsoft-aspnetcore-mvc-versioning，但在这种情况下，Swagger 页面会丢失 api 版本并始终使用默认的 v1.0。如代码sn-p所示，我使用的是QueryStringApiVersionReader和HeaderApiVersionReader，但是我不想支持url api版本。

注意：API 确实为所有版本（例如 V1、V1.1、V2.0）提供了多个 swagger json 页面

Answer 1

您可以尝试操作过滤器。这和 Helder 的方案类似，但是实现不一定要在文档级别，所以看起来更简单：

public void Configure(SwaggerGenOptions options)
{
    // Filter out `api-version` parameters globally
    options.OperationFilter<ApiVersionFilter>();
}

internal class ApiVersionFilter : IOperationFilter
{
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    {
        var parametersToRemove = operation.Parameters.Where(x => x.Name == "api-version").ToList();
        foreach (var parameter in parametersToRemove)
            operation.Parameters.Remove(parameter);
    }
}

Answer 2

你可以add your own custom CSS 并使用它来隐藏这些元素（并进行您想要的任何其他自定义）。

app.UseSwaggerUI(c =>
{
    ...
    c.InjectStylesheet("/swagger-ui/custom.css");
    ...
});

---

编辑 - 示例：

假设你想隐藏——在我的例子中；您可以轻松地将其调整为适合您的 - 此“删除篮子”操作中的 tenantId 参数：

这样可以：

div#operations-baskets-remove tr[data-param-name="tenantId"] {
    display: none;
}