apifox自动导入apidoc接口数据

2022-03-25 08:55:00 # 清学小记

使用apiDoc生成接口数据

查看apiDoc官方文档

  • 全局安装apiDoc,必须安装0.29.0或以下版本;新版本不再支持生成api_data.json等数据文件,导致无法导入Apifox
1
npm install apidoc@0.29.0 -g
  • 创建配置文件apidoc.json
1
{  "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
  • 保存立即导入
  • 按需开启自动导入