如何在ServiceStack中启用swagger？

Question

我在介绍幻灯片中找到了提醒。但没有其他地方。是不是还没完成？

编辑：显然它在待办事项列表中。

有没有什么好方法可以自动记录RestAPI？

Answer 1

要为服务堆栈启用Swagger，请按照服务堆栈维基上的Swagger API页面进行操作。

详细步骤：

1. 在包管理器控制台中运行Install-Package ServiceStack.Api.Swagger。

2. 使用以下命令在AppHost.cs中启用Swagger插件：

   using ServiceStack.Api.Swagger;
   
   public override void Configure(Container container)
   {
     ...
     Plugins.Add(new SwaggerFeature());
     ...
   }
   

3. 使用http://localhost:port/swagger-ui/index.html

访问Swagger用户界面

Answer 2

根据Trello，这是一个“正在做”但后来被转回“待办事项”;并且在github repo中有一个Swagger.Api模块，所以假设它只是部分完成。

修改

正如已经指出的那样（但为了完整起见，因为这是接受的答案），SwaggerUI已准备好服务堆栈（并且圣洁的moly它真棒）。 Github wiki已在最近几天填写完毕，并且它非常容易上手。运行

Answer 3

现在看起来已经完成并准备就绪，请查看v3.9.35 @ https://github.com/ServiceStack/ServiceStack/wiki/Release-Notes的发行说明

Answer 4

嗯...对不起，如果我误解了这个：

  

有没有什么好方法可以自动记录RestAPI？

...但是当我用属性装饰我的DTO或服务时：

[Route("/hello","GET")]
[Route("/hello/{Name}","POST,GET")]
public class Hello : IReturn<HelloResponse>
{
    public string Name { get; set; }
}

servicestack生成的默认元数据页面记录了用法：

这不是你想要的吗？

Answer 5

当我使用.Net Core ServiceStack时，因此我为Swagger UI安装了ServiceStack.Api.Swagger.Core nuget。

但这给了我'500：未定义的错误'。

然后我删除了ServiceStack.Api.Swagger.Core并安装了ServiceStack.Api.Swagger。

那很好用。