构建万能 MOCK-API
前言
现代化项目基本上都是前后端分离的,基于此,后端
可以通过Postman
等工具调试自己的功能是否能正常运行,而针对前端
来说,有些场景需要依赖后端
的数据进行测试,这样就会被变成了单线程
,被阻塞
了,着实没必要
为了解决这个问题,特地构建了一个镜像,在简单
的新功能开发的时候,可以直接修改环境变量,实现跟生成环境
一模一样的数据结构
,请求地址
,和完全相同的交互方式
,这样就能无缝切换
基础的请求地址,而不用改动任何功能
使用说明
- 直接将
Docker 镜像
运行起来即可,也可以自行构建环境运行
GIT 地址
https://github.com/smallseapig/power-api.git
基础用法
- 通过在指定路径创建
JSON
实现接口自动生成
模拟 API
-
调用创建模拟
API
的接口,即可自动生成可访问的API
接口 -
只支持
POST
方法,支持以下几种接口,后缀为get-mock
,create-mock
,delete-mock
,delete-mock-all
,append-mock
的方法-
查询所有可用的
MOCK-API
:http://localhost:8080/get-mock
-
新增(覆盖)可用的
MOCK-API
:http://localhost:8080/power/mock-api/create-mock
- 新增完成后,通过去掉后缀
create-mock
即可正常调用,如:http://localhost:8080/power/mock-api
- 新增完成后,通过去掉后缀
-
删除可用的
MOCK-API
:http://localhost:8080/power/mock-api/delete-mock
-
查询所有可用的
MOCK-API
:http://localhost:8080/delete-mock-all
-
【高定制功能】针对定制数据结构,支持
数据追加
和分页查询
- 定制的数据结构为
xxx.data.records
,示例如下:
json{ "code": 0, "msg": "查询成功!", "data": { "records": [ { "id": "1864592907632418825" }, { "id": "1864592907632418825" } ], "total": 220, "size": 10, "current": 1, "pages": 22, "tag": null } }
-
追加数据:
http://localhost:8080/power/mock-api/append-mock
-
分页查询:针对定制化数据,默认支持分页查询和条件查询,如:
http://localhost:8080/power/mock-api
,如果数据为常规数据,会自动切换为普通的MOCK-API
- 定制的数据结构为
-
使用案例
- 通过
Postman
等工具调用接口
- 新增
MOCK-API
只支持POST
方法,调用接口http://localhost:8080/power/mock-api/create-mock
,在body
中写入以下数据
json
{
"code": 200,
"msg": "测试数据",
"data": []
}
- 使用
MOCK-API
只支持POST
方法,调用接口http://localhost:8080/power/mock-api
高级用法
万能接口
- 直接调用
http://localhost:8080/
的任意接口,支持后缀为get
,create
,page
,update
,delete
的所有方法
使用案例
-
使用
GET
方法调用查询接口,http://localhost:8080/power/get
- 支持
params
的id
- 支持
body
的id
- 支持
body
的ids
,需要为数组
- 支持
-
使用
POST
方法调用新增接口,http://localhost:8080/power/create
-
使用
POST
方法调用查询接口,http://localhost:8080/power/page
-
使用
PUT
方法调用查询接口,http://localhost:8080/power/update
-
使用
DELETE
方法调用查询接口,http://localhost:8080/power/delete
- 支持
params
的id
- 支持
body
的id
- 支持
body
的ids
,需要为数组
- 支持