如何正確使用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" } 
    } 
});