ServiceStack OpenAPI路由/标记描述

我已经将我的项目升级为使用最新版本的ServiceStack，并使用OpenApiFeature而不是Swagger功能

我在RouteSummary中指定的描述过去常常以大摇大摆的方式显示，但在OpenApi下，它们似乎没有得到尊重。是否有一个新的地方，或者我的配置中遗漏了什么

Plugins.Add(new OpenApiFeature
{
    RouteSummary = {
        { "/clubs", "Customer club lookups" },
        { "/customers", "Customer demographics, receipts and transactions" },
        { "/dates", "Fiscal date breakdowns" }
    }
});

---

Swagger功能遵循Swagger 1.2规范，该规范将API列表与其规范分离，API允许您为路由集合指定描述。但是，规范中的组合开放API规范删除了此功能

这已被替换为，我在中添加了显式支持，您可以使用相同的标记将要显示的操作分组在一起，例如：

[Tag("clubs")]
[Route("/clubs", "GET")]
public class GetClubs {}

[Tag("clubs")]
[Route("/clubs/{Id}", "PUT")]
public class UpdateClub 
{
    public int Id { get; set; }
}

然后，您可以在注册

OpenApiFeature

时为每个标记指定描述，例如：

Plugins.Add(new OpenApiFeature
{
    Tags =
    {
        new OpenApiTag
        {
            Name = "clubs",
            Description = "Customer club lookups",
        },
        new OpenApiTag
        {
            Name = "customers",
            Description = "Customer demographics, receipts and transactions",
        },
        new OpenApiTag
        {
            Name = "dates",
            Description = "Fiscal date breakdowns",
        },
    }
});

---

新的

标签

系列可从现在的v4.5.13中获得。

感谢您如此快速地添加了对它的支持。你真棒！