php apidoc生成接口文档实例
发布时间:2022-02-24 09:12:45 所属栏目:PHP教程 来源:互联网
导读:api 生成接口文档示例: { name: 9月份赠险领取分享活动微信接口, version: 1.0.0, description: 9月份赠险领取分享活动微信接口文档 (t=1) , sampleUrl : http://www.Cuoxin.com/ } 另存文件名为:apidoc.json apidoc -i 要生成文档的项目目录 -o 接口文件
api 生成接口文档示例: { "name": "9月份赠险领取分享活动微信接口", "version": "1.0.0", "description": "9月份赠险领取分享活动微信接口文档 (t=1) ", "sampleUrl" : "http://www.Cuoxin.com/" } 另存文件名为:apidoc.json apidoc -i 要生成文档的项目目录 -o 接口文件的生成目录 接口代码文件代码如下: /** * @api {post} /news/lists 新闻信息列表 * @apiVersion 1.0.0 * @apiName lists * @apiGroup User * @apiPermission 登录用户 * * @apiDescription 用户登录后进入该页面,将显示新闻信息列表 * * @apiSampleRequest /v1/news/lists * * @apiSuccess (返回值) {string} id 主键ID * @apiSuccess (返回值) {string} name 客户姓名 * @apiSuccess (返回值) {string} user_head_img 客户头像 * @apiSuccess (返回值) {integer} sex 性别:0-未设置,1-男,2-女 * @apiSuccess (返回值) {string} demand 客户需求 * * @apiSuccessExample {json} 成功示例: * {"code": 1,"msg": "","data": {"id": "57b3cdb46b787","name": "余浩苗","user_head_img": "userHead/2016-08-18/1034587522576.jpg","sex": "1","demand": "本人想买保险,请速联系!"}} * * @apiErrorExample (json) 错误示例: * {"code":-1,"msg":"密码错误","data":{}} */ /////////////////////////////////////// /** * @api {post} /news/rob 抢客户 * @apiVersion 1.0.0 * @apiName rob * @apiGroup User * @apiPermission 登录用户 * * @apiDescription 抢客户 * * @apiParam {string} id 主键ID * * @apiSampleRequest /v1/news/rob * * @apiSuccessExample {json} 成功示例: * {"code":1,"msg":"","data":{}} * * @apiErrorExample (json) 错误示例: * {"code":-1,"msg":"错误信息","data":{}} */ (编辑:威海站长网) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |
站长推荐
热点阅读