ap-cli 前端模拟接口服务脚手架
项目地址
依据接口定义,帮助你快速的完成接口模拟工作。
主要功能:
- [x] 通过json、js、swagger文件模拟接口数据
- [x] 通过正则匹配指定需要mock的文件
- [x] 生成简单markdown接口文档
开始
下载ap-cli
$ npm install ap-cli -g创建data.json
[ { "url": "/api/get/index", "method": "get", "response": { "name": "pc", "status": "success" } }]运行
$ ap-cli -m data.json现在打开 http://localhost:3000/api/get/index ,你会得到
{ "name": "pc", "status": "success" }同时会在当前文件目录生成一个简单的markdown接口文档
使用
1、通过js方式模拟数据
格式查看
data.js
运行
查看接口
http://localhost:3000/api/get/userList
2、通过swagger文件模拟数据
这种方式主要是通过swagger生成一个xx_new.json文件,然后进行模拟数据
# 运行会生成一个swagger_new.json文件$ ap-cli -s swagger.json# 模拟数据$ ap-cli -m swagger_new.json通过正则匹配指定要模拟的文件
当前目录下有3个文件a1.json、a2.js、b1.js,你可以通过正则只模拟a1.json和a2.js文件的数据。
$ ap-cli -m all -r /^a/CLI用法
# 缩写 完整 默认 说明 1 -m --mock [fileName] 'all' 模拟接口服务,[fileName]当前目录下要mock的文件名,[all]默认当前目录下的所有文件 2 -r --regexp [regexp] 无 通过正则匹配需要mock的文件 3 -s --swagger [fileName] 无 通过swagger生成json模板文件,[fileName]当前目录下的swagger文件名 4 -p --port [port] 3000 指定mock的端口
完整模板及说明
不管是json、js、swagger文件,最终都是转换成下面的格式进行处理。
示例
主要属性说明
# 字段 类型 说明 默认 是否必须 备注 1 summary string 接口概述 xxx接口 否 无 2 url string 接口地址 /api 是 无 3 method string http请求方式 get 是 无 4 parameters / 接口请求参数 无 否 可显示为表格(详见下1-1.parameters属性说明) 5 response / 接口响应数据 无 是 无
1-1. parameters属性说明
# 字段 类型 说明 默认 是否必须 备注 1 parsing boolean 是否解析 false 否 无 2 child object [] 子节点 无 否 子节点属性(详见1-1-1.child属性说明)
1-1-1. child属性说明
# 字段 类型 说明 默认 是否必须 1 key string 字段名称 - 是 2 type string 字段类型 string 是 3 description string 字段说明 无 否 4 required boolean 是否必须 false 否 5 child object [] 子节点数据 无 否
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。