代码拉取完成,页面将自动刷新
同步操作将从 caixw/apidoc 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
apidoc 是一个简单的 RESTful API 文档生成工具,它从代码注释中提取特定格式的内容,生成文档。 目前支持支持以下语言:C#、C/C++、D、Erlang、Go、Groovy、Java、JavaScript、Pascal/Delphi、 Perl、PHP、Python、Ruby、Rust、Scala 和 Swift。
具体文档可参考:https://apidoc.tools
/**
* <api method="GET" summary="获取所有的用户信息">
* <path path="/users">
* <query name="page" type="number" default="0">显示第几页的内容</query>
* <query name="size" type="number" default="20">每页显示的数量</query>
* </path>
* <tag>user</tag>
* <server>users</server>
* <response status="200" type="object" mimetype="application/json">
* <param name="count" type="int" optional="false" summary="符合条件的所有用户数量" />
* <param name="users" type="object" array="true" summary="用户列表">
* <param name="id" type="int" summary="唯一 ID" />
* <param name="name" type="string" summary="姓名" />
* </param>
* <example mimetype="application/json">
* <![CDATA[
* {
* "count": 500,
* "users": [
* {"id":1, "name": "管理员2"},
* {"id":2, "name": "管理员2"}
* ],
* }
* ]]>
* </example>
* </response>
* <response status="500" mimetype="application/json" type="obj">
* <param name="code" type="int" summary="错误代码" />
* <param name="msg" type="string" summary="错误内容" />
* </response>
* </api>
*/
func login(w http.ResponseWriter, r *http.Request) {
// TODO
}
go get github.com/caixw/apidoc
支持多种本地化语言,默认情况下会根据当前系统所使用的语言进行调整。
也可以通过设置环境变更 LANG
指定一个本地化信息。*nix 系统也可以使用以下命令:
LANG=lang apidoc
将其中的 lang 设置为你需要的语言。
若需要将 apidoc 当作包集成到其它 Go 程序中,可参考以下代码:
// 初始本地化内容
apidoc.Init(language.MustParse("zh-Hans"))
// 可以自定义实现具体的错误处理方式
h := message.NewHandler(...)
output := &output.Options{...}
inputs := []*input.Options{
&input.Options{},
}
apidoc.Buffer(h, output, inputs...)
请阅读 CONTRIBUTING.md 文件的相关内容。
本项目源码采用 MIT 开源授权许可证,完整的授权说明可在 LICENSE 文件中找到。
文档内容的版权由各个文档各自表述。
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。