在 handler 中要生成文档的函数上,按照以下格式添加注释
// Swagger:ServicePath tag1,tag2 接口名称
例如
// Swagger:CtrContract 合同 转移合同
然后运行下面的命令生成 swagger.yml
go run swaggerui/swagger.go -o swaggerui/swagger.yml
在配置文件的 setting 中添加
swagger = true
启动服务即可在 18080 端口访问到 swagger 文档
如果需要对使用 swaggerui 发出的请求做不鉴权处理,在配置文件的 setting 中添加
fake-auth-for-swagger = true
启用这个配置后,对所有请求直接设置了一个固定的 userinfo,不再做鉴权处理