应用介绍
给「后端接口还没就绪」的联调过程配一批固定返回的模拟接口,外加几个界面演示场景。
它解决什么问题
前后端分离开发时有个绕不开的卡点:页面要调十个接口,后端只交付了三个。剩下的要么干等,要么在前端代码里临时造数据——假数据散落在各个业务文件里,等真接口上线再删干净很麻烦,字段对不上也不容易发现。另一种做法是在服务端造假接口:给每个未完成的接口配一个地址和一份固定返回内容,前端照真实路径去请求,等真接口上线只改地址。
代价是琐事多:谁来配、配在哪儿、怎么改、怎么确认改对了。这个工具把这些配置收进同一个界面——按应用(app)分组管理模拟接口,每条接口登记路径、请求方式、响应格式、请求体与响应数据体;前端按约定路径请求,就能拿到配置好的响应。列表里还能看到每条接口被调用过多少次、当前配了哪些应用。
它同时收了一组用于界面演示的场景入口(物联网、移动作业、蜜罐、拓扑图、反诈拦截、智慧城市等),在没有真实数据源时用来展示界面形态。
核心功能
- 按应用管理接口:模拟接口按应用名称分组展示,应用列表显示最后更新时间、接口调用次数与成功/失败计数,并给出一个成功率的圆环。
- 接口定义:每条接口需填写应用名、接口路径、接口名称、接口描述、请求方式(GET / POST)、响应格式(json / html)、请求体内容与响应数据体。
- 模拟响应服务:以
/sdk/Mock/rx?app={应用}&api={接口路径}的形式对外提供数据,服务端按该接口配置的格式返回 JSON 或 HTML 内容,并把调用次数加一。 - 试调:在接口列表点「发送」,页面会按配置向对应 mock 地址发起一次请求,用来确认配置的返回内容是否符合预期。
- 新增与编辑:提供新增、编辑入口,编辑时会读取该接口当前的配置回填表单。
- 演示场景入口:首页以九宫格列出预置场景,其中「物联网」会跳转到平台对应的演示页面。
怎么用
- 1打开
/wit-lab/mock,未登录会跳转到登录页。 - 2进入应用列表,按应用名称找到已有接口分组,可以看到最后更新时间与调用计数。
- 3点进某个应用查看接口列表:每条显示请求方式、路径、描述、响应格式、请求体与响应数据体。
- 4点「新增」或「编辑」,填写应用名、路径、请求方式、响应格式与响应数据体后提交。
- 5用「发送」验证返回;前端联调时按同一路径请求
/sdk/Mock/rx。
常见问题
Q:它会自动生成假数据吗?
A:不会。这里没有随机数据或字段模板生成,返回内容是按接口逐条手写的响应数据体。
Q:接口怎么被调用?
A:以 /sdk/Mock/rx?app=<应用>&api=<接口路径> 的形式请求,服务端按该接口配置的响应格式(json 或 html)返回你填写的响应内容。
Q:需要登录吗?
A:需要。进入首页会校验登录状态并跳转登录页;新增、编辑这类写操作在服务端也要求已登录。
Q:能拦截真实请求、按规则自动返回 Mock 数据吗?
A:不能。代码里没有请求拦截或代理转发,只能通过约定的 mock 地址取配置好的数据。
Q:首页那些场景可以直接用吗?
A:它们是用于界面演示的模板入口,不依赖 mock 接口数据,也不能当作真实业务系统使用。
Q:接口是按什么维度归类的?
A:按「应用名 + 接口路径」定位一条记录,列表展示的是共享的接口(新建时按共享标记写入),因此同一个应用下会有多条接口并列。