DEMO
请求该接口方法预期返回什么样的结果。
请求方式
请求参数
例如：/admin/user/
对该方法做一个请求示例，来进一步减少前端思考成本。
wx.request({
url: 'test.php', //接口地址
data: {
x: '',
y: ''
},
header: {
'content-type': 'application/json' // 默认值
},
success (res) {
console.log(res.data)
}
})
请求示例
返回结果
状态码说明
主要说明该方法实现什么功能，涉及术语需要标注。
功能描述
对该方法做一个返回示例，来进一步减少前端思考成本。
{
code:100,
message: '请求示例',
data: {
..
}
}
此块最好使用表格来描述。
用最简洁清晰的语言，让不懂后端的前端一看就懂。
到这里就结束了，当然要遵守公司需求以及公司制定的规范。
目前市面上有很多网站提供团队文档协作服务，可以使用它们解决方案，团队可以在线撰写文档，可被团队所有人可见。大大减少沟通成本，这里不列出了，避免广告嫌疑。
【字段】：对应的字段名称，如userName/pwd。【说明】：对于该字段的说明，如用户名/密码。【类型】：对于该字段类型，如Array/Object。【是否必填】：Y/N/True/False【备注】：对于该接口有什么备注。
返回示例
调用该接口前端需要使用什么方式来请求
后端自定义状态码必须要写此状态码说明。
对返回的状态码说明，如返回400代表错误，200代表正常。
调用该接口时，前端需要传递哪些参数值，主要有以下几个方面：
URL地址
文章为作者独立观点，不代表股票交易接口观点
股民评论