Swagger 为自定义 Restful API (C#.NET) 生成定义答案

【问题标题】：Swagger to generate definition for custom Restful API (C#.NET)Swagger 为自定义 Restful API (C#.NET) 生成定义
【发布时间】：2016-08-03 07:19:54
【问题描述】：

我正在尝试将 swagger 用于我的 RESTful api（.net 和 c#）。它是一个自定义的 restful api（不是 ASP.NET Web API 也不是 Web 应用程序）。

public interface IEmployee
{
    [CustomSecurity(Session.Required)]
    EmployeeResponse GetEmployee(EmployeeRequest request);  
}

我正在使用 NSwag (https://github.com/NSwag/NSwag)，它有 NSwagStudio 来生成规范，但没有成功，因为它没有指定方法。有没有其他方法可以做到这一点？如何让 swagger 理解我对操作的自定义属性？

【问题讨论】：

标签： swagger swagger-ui swagger-2.0 swagger-editor nswag

【解决方案1】：

默认情况下仅支持 web api 类，但也许您可以编写自己的命令行工具，使用生成器和接口作为通用参数（但使用 web api 规则）：https://github.com/NSwag/NSwag/wiki/WebApiToSwaggerGenerator

【讨论】：

或者试试命令行工具和你的界面作为参数(/controller:full.type.name)