apifox自动导入apidoc接口数据

使用apiDoc生成接口数据

查看apiDoc官方文档

  • 全局安装apiDoc,必须安装0.29.0或以下版本;新版本不再支持生成api_data.json等数据文件,导致无法导入Apifox

    1
    npm install apidoc@0.29.0 -g
  • 创建配置文件apidoc.json

    1
    2
    3
    4
    5
    6
    7
    {
    "name": "example",
    "version": "1.0.0",
    "description": "apiDoc basic example",
    "title": "Custom apiDoc browser title",
    "url" : "https://api.github.com/v1"
    }
  • 生产文档命令

1
apidoc -i src -o apidoc/ -f .jsp
  • 监听文件变动,执行生产文档命令
    1
    2
    3
    4
    5
    6
    7
    # 全局安装 nodemon
    npm install -g nodemon

    # nodemon监听指定目录文件变动,并执行指令
    nodemon -w input/ -e js -x "apidoc -i input/ -f .js -o apidoc/"
    # or
    nodemon --watch input/ --ext js -exec "apidoc --input input/ --file-filters .js --output apidoc/"

使用Apifox自动导入apiDoc数据

  • 创建好项目
  • 依次打开项目设置数据管理导入数据(自动同步)
  • 数据源格式选择apiDoc数据源url填入http://xxx.xxx/api_data.json
  • 保存立即导入
  • 按需开启自动导入