如何在ServiceStack中启用swagger?

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

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

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

根据Trello的说法,这是一个“做”,然后又被移回“待办事项”; 并且在github repo中有一个Swagger.Api模块,所以假设它只是部分完成。

编辑

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

要为服务堆栈启用Swagger,请按照Service Stack wiki上的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 UI

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

嗯…对不起,如果我误解了这个:

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

…但是当我用属性装饰我的DTO或服务时:

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

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

在此处输入图像描述

这不是你想要的吗?