加入收藏 | 设为首页 | 会员中心 | 我要投稿 拼字网 - 核心网 (https://www.hexinwang.cn/)- 科技、建站、经验、云计算、5G、大数据,站长网!
当前位置: 首页 > 站长学院 > PHP教程 > 正文

php apidoc生成接口文档实例

发布时间:2022-02-24 07:16:38 所属栏目: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":{}}
   */ 

(编辑:拼字网 - 核心网)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!