如何正确使用ServiceStack中的Api属性来命名SwaggerUI中的服务？

Question

使用Swagger-UI和ServiceStack，我试图使用Api属性来命名我的服务更清洁。

我很难找出属性需要添加description属性到由swagger创建的resources端点中的api。

我有一个基本请求被我的客户端点的其他一些请求继承。 Api属性仅在放置在此特定请求dto时才起作用。如果我将它移动到另一个，它将停止工作。这里是什么我昂首阔步页面看起来像〔实施例：

下面是该代码：

，这里是似乎没有工作的代码：

我想有一个好记的名称为每个SERVIC即谢谢！

编辑：我确实追踪了ServiceStack代码库中的一些代码，表明它正在寻找FirstAttribute。我试着通过改变事物的顺序来进行测试，但也没有得到理想的结果。如果有帮助，我正在寻找AttributeExtensions.cs。

Answer 1

您可以使用[Api("API Description")]或[Description("API Description")] 的说明添加到一个服务虽然这并不总是直接多个路由映射到扬鞭路线描述为扬鞭UI组覆盖多个不同的单个顶级路线下共享顶级路线的服务。

但是你可以在SwaggerFeature指定路由聚合与RouteSummary字典，e.g：

Plugins.Add(new SwaggerFeature { 
    RouteSummary = { 
     { "/top-level-path", "Route Summary" } 
    } 
});