如何将Swagger添加到我的Azure云服务工作者角色

Question

我有Azure云服务（工作者角色）正在运行。 此辅助角色使用WebHttpBinding绑定公开Web端点。它使用WebInvoke公开了几个REST端点。

例子：

[OperationContract] 
[WebInvoke(UriTemplate = "/Test", 
    Method = "GET", 
    RequestFormat = WebMessageFormat.Json, 
    ResponseFormat = WebMessageFormat.Json)] 
bool Test(); 

在哪里或如何将需要开始一个扬鞭UI添加到我的项目，使外部开发人员能够看到我的API文档？

任何帮助表示赞赏。我使用.NET 4.5.2和C＃

Answer 1

目前有两种包装的NuGet -

核心库（Swashbuckle.Core）和便利包（Swashbuckle），提供自动引导。

后者只适用于常规IIS托管的WepApi's。对于所有其他主机环境，您只应安装Core库，然后按照以下说明手动启用Swagger路由。

一旦安装并启用了，你应该能够分别浏览以下扬鞭文档和UI端点：

“你的根目录的URL” /昂首阔步/文档/ V1

“你 - 根 - URL“/招摇

这里是GitHub的页面，这个项目的完成您参考： https://github.com/domaindrivendev/Swashbuckle