golang学习笔记7 使用beego swagger 实现API自动化文档

API 自动化文档 - beego: 简约 & 强大并存的 Go 应用框架
https://beego.me/docs/advantage/docs.md

使用beego开发api server 和前端拆分开发，使用swagger自动化生成API文档

Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。总体目标是使客户端和文件系统作为服务器以同样的速度来更新。
项目地址是：http://swagger.io/
使用 beego 开发自带集成了 swagger的东西。
https://beego.me/docs/advantage/docs.md
github 地址：
https://github.com/beego/swagger

到项目目录下执行命令：
bee run -gendoc=true -downdoc=true
会自动下载最新的 swagger 压缩文件
启动成功，直接访问
http://localhost:8080/swagger/
会出来两个url，http://localhost:8080/swagger/swagger.json
http://localhost:8080/swagger/swagger.yml

EnableDocs = truemain.go_ "beeapi/docs"bee run -gendoc=true -downdoc=true-gendoc=true-downdoc=true

到 https://github.com/swagger-api/swagger-ui 下载zip包，
解压后把dist文件夹复制到swagger目录下即可访问里面的index.html
为了方便把文件夹改名成show，把index.html 的url改成本地的
//url: "http://petstore.swagger.io/v2/swagger.json",
url:"http://localhost:8080/swagger/swagger.json",
在浏览器访问
http://localhost:8080/swagger/show/index.html
即可看到自己项目的api文档了，示例如下：

golang学习笔记7 使用beego swagger 实现API自动化文档_api