关于npm:Apidoc生成接口文档PHP

37次阅读

共计 1889 个字符,预计需要花费 5 分钟才能阅读完成。

一开始应用 PHPDocumentor 生成接口文档, 然而, 感觉有点不够不便, 后换成了 apidoc.

装置

npm install apidoc -g

或者应用 yarn 装置

yarn global add apidoc

配置(apidoc.json)

每次导出接口文档都必须要让 apidoc 读取到 apidoc.json 文件 (如果未增加配置文件,导出报错),你能够在你我的项目的 根目录 下增加 apidoc.json 文件,这个文件次要蕴含一些我的项目的形容信息,比方题目、简短的形容、版本等,你也能够退出一些可选的配置项,比方页眉、页脚、模板等。
apidoc.json

{
  "name": "零碎接口文档",
  "version": "0.0.1",
  "description": "文档总形容",
  "title": "apidoc 浏览器自定义题目",
  "url" : "文档 url 地址"
}

我的 –order 排序

{
  "name": "平安质量检查 ServiceAPIs",
  "version": "1.0.0",
  "description": "平安质量检查接口文档",
  "title": "API 接口文档",
  "url": "http://safety.local:8889",
  "sampleUrl": "http://safety.local:8889",
  "order": [
    "根底接口",
    "myWorkbench",
    "查看流动",
    "getActivity",
    "getActivityInfo",
    "addActivityFile",
    "getRectify",
    "getInfoList",
    "handleActivity",
    "searchAccount"
 ]
}

示例:

/**
 * @api {GET} /api.php?m=check&a=getActivity 查看所有查看流动列表
 * @apiName getActivity
 * @apiGroup 查看流动
 * @apiDescription 查看流动列表
 *
 * @apiParam {String} token="s2iph9ik" 用户 token
 * @apiParam {Number} adminid=3 用户 id
 * @apiParam {Number=0,1,2,3,4} [type=0] 流动性质 0 默认 1 专项查看 2 综合查看 3 月度查看 4 季度查看
 * @apiParam {Number=0,1,2,3} [status=0] 查看活动状态 0 未开始 1 进行中 2 已实现 3 已勾销
 * @apiParam {Number} [page=1] 页数
 * @apiParam {Number} [num=10] 每页展现数量
 *
 * @apiSuccess {Number} code 返回信息码 200 示意申请胜利
 * @apiSuccess {String} msg 返回阐明信息
 * @apiSuccess {boolen} success 申请胜利
 * @apiSuccess {json} data 胜利数据
 * @apiSuccess {Number} activity_record_num 问题记录数量
 *
 * @apiSuccessExample Success-Response:
 * HTTP/1.1 200 OK 
 *   
 * {       
 *     "code": 200, 
 *      "msg": "", 
 *      "data": [{
 *           "id": "6", 
 *           "title": "2020 年第二季度综合查看",
 *           "property": "专项查看",
 *           "check_project": "",
 *           "dept": "xxxx 部",
 *           "check_range": "xx 标段,xx 标段",
 *           "check_status": "0",
 *           "start_time": "2020-08-19",
 *           "end_time": "2020-08-31", 
 *           "add_time": "2020-09-01 09:00:49",
 *           "summary": "查看查看",
 *           "remark": "",
 *           "file": "17", 
 *           "check_name": "bim", 
 *           "check_id": "13", 
 *           "check_phone": "17611241011",
 *           "uid": "3",
 *           "issue_status": "已整改回复",
 *           "file_info": [{
 *               "filename": "创优网上填报零碎.docx",
 *               "filepath": "upload/2020-05/22_12131327.docx"
 *           }], 
 *           "activity_record_num": 2
 *   }],
 *      "success": true
 *   } 
 * 
 * @apiSampleRequest /api.php?m=check&a=getActivity
 */

成果:

其余的解释请查看这篇文章吧:
apiDoc 详解

正文完
 0