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

Question

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

例：

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

我需要在哪里或如何开始向项目添加Swagger UI，以便外部开发人员可以查看我的API上的文档？

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

Answer 1

当前有两个Nuget软件包-

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

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

安装并启用后，您应该能够分别浏览以下Swagger文档和UI端点：

“您的根网址” / swagger / docs / v1

“您的根网址”

这是您对该项目的完整参考的github页面： https : //github.com/domaindrivendev/Swashbuckle