导入导出与 AI 接入
导入导出
入口在我的控制台的「导入导出」页签。面板上半部分是导出,下半部分是导入;导入支持四种来源,用页签切换:
| 来源 | 内容 | 说明 |
|---|---|---|
| 规则 JSON | anymock 导出的那份文件(只贴 rules 数组也认) | 整份还原:匹配条件、响应序列、数据集绑定都还在,适合备份与迁移 |
| OpenAPI / Swagger | 接口文档,OpenAPI 3.x 与 Swagger 2.0 都支持,JSON 与 YAML 都可以直接贴 | 路径与方法照搬,响应体优先取 example,没有就按 schema 生成示例数据;Swagger 2.0 的 basePath 会自动拼到路径前 |
| Postman 集合 | Postman 里集合右键 Export 选 Collection v2.1 得到的文件内容 | 把别人整理好的接口清单变成规则:见下面一节 |
| HAR 抓包 | 浏览器「另存为 HAR」得到的文件内容 | 把真实抓包变成规则:见下面一节 |
导入分两种方式:merge(追加,默认)与 replace(先清空再导入)。replace 会先删再导,面板里会二次确认,并把将要删掉的范围和条数写清楚;未登录时 replace 直接拒绝(避免一次匿名请求清掉别人的规则)。路径撞车时会自动加后缀(orders-1),不会让整批导入卡在一条冲突上。
内容从哪来
| 方式 | 什么时候用 |
|---|---|
| 粘贴内容 | 文档内容已经在剪贴板里了,直接贴进输入框 |
| 本地文件 | 选本机的一个文件。读进来会自动认格式(OpenAPI / Swagger、Postman、HAR、anymock 规则 JSON)并把上面的来源页签切过去,内容还能再改 |
| 远程链接 | 只有 Swagger 文档的地址。填上去就行,见下面一节 |
远程链接导入(含认证)
很多 Swagger、OpenAPI 文档都是挂着的一个 URL,逐个拷贝内容并不现实。选「远程链接」填上地址即可:
- 文档由服务端去拉取。文档站点基本都不给跨域头,浏览器直连一定会被拦下,所以这一步必须放在服务端;
- 需要认证时选对应的方式:Bearer Token、Basic 账号 + 口令、自定义请求头(一行一个
X-Api-Key: abc123)。凭据只用于这一次拉取,不保存; - 点「拉取预览」可以先把内容取回来看看是不是想要的,再决定导不导;直接点「导入」则服务端拉完立刻导入;
- 出于安全,指向内网 / 本机 / 云元数据地址(169.254.169.254)、非 http(s) 协议、数据库端口 的请求会被拒绝,重定向也会逐跳重新校验。
按项目导入(把范围收进一层)
导入时可以指定「导入到哪个项目」。选了之后,这次导入的作用范围就只剩那一个项目:
- 导入的接口全部挂到该项目下,访问路径自动带上项目前缀(前缀
order+ 路径orders→order/orders); - replace 只清空这个项目里的接口,项目之外的规则不会被动到;
- 顺带建出来的数据集也归属同一项目(接口在项目里、数据散在外面同样找不着);
- 没选项目时按上面的身份范围走。项目不存在或不属于你,会直接报错,而不是默默退回账号范围。
清空之前面板会把范围名 + 准确条数报出来,确认框里也是同一套数字:"清空这 12 条"和"清空 87 条"不是一个量级的决定。
Postman 集合导入
Postman 里对着集合右键 Export,格式选 Collection v2.1(v2.0 也认),把文件内容贴进「Postman 集合」页签即可:
- 集合里的目录会一层层往下翻,翻到真正的请求为止,不用自己先把目录拆平;
- 取方法、路径、示例响应的状态码与正文。请求头 / 请求体不导(否则规则会要求带上当时的 token 才命中),响应头只留 Content-Type;
- 一个请求存了多份示例响应(成功 / 失败 / 边界)时,合并成一条规则的响应序列,按顺序循环返回;
- 路径里的
:id与{{id}}会换成{id}——不换的话每个 id 都是一条死路径;开头的{{baseUrl}}是域名占位,直接丢掉; - 没存示例响应的请求也会建出来,正文先给个
{}占位,地址立刻能调,内容回头自己填; - 路径常带
/api/v1之类前缀,想去掉就在「去掉路径前缀」里填/api/v1; - 集合自带的变量(根节点
variable里声明的{{baseUrl}}、{{tenant}}之类)会替换成它声明的值,路径变量{{id}}不会被误伤。
Postman 动态变量:直接就能用
示例响应里常带着 {{$randomInt}}、{{$randomFullName}}、{{$guid}}
这类写法(官方叫 dynamic variables,一共 118 个)。它们底层就是 fakerjs,而本站的假数据本身 就对齐 fakerjs,所以这里不需要改一个字——导入后原样保留,每次调用照常出随机值:
| Postman 写法 | 等价的本站写法 |
|---|---|
{{$guid}} {{$randomUUID}} | {{faker.string.uuid}} |
{{$timestamp}} / {{$isoTimestamp}} | {{now.unix}} / {{now.iso8601}} |
{{$randomInt}} | {{faker.number.int(0,1000)}} |
{{$randomFullName}} {{$randomEmail}} | {{faker.person.fullName}} {{faker.internet.email}} |
{{$randomCity}} {{$randomCountry}} | {{faker.location.city}} {{faker.location.country}} |
几个要说的:图片那一批($randomCatsImage 之类)官方给的是已经停服的
lorempixel.com,这里换成可用的随机图片地址;不认识的 $ 变量原样保留, 不会静默变空。想彻底换成本站写法,导入时带上 convert=1(MCP 的
import_postman 也有这个参数),没有等价写法的会保持不动。
HAR 抓包导入
F12 → Network → 刷新页面 → 右键「另存为 HAR」,把文件内容贴进 HAR 页签即可:
- 只取请求方法与路径、响应状态码与响应体。请求头 / 请求体不导(否则规则会要求带上当时的 cookie、token 才命中);响应头也不导(HAR 里大半是 Content-Length、Content-Encoding 这类传输层头,照搬反而对不上),Content-Type 单独保留;
- 同一个「方法 + 路径」抓到多次时,会合并成一条规则的响应序列,按顺序循环返回——正好复现"时好时坏"的接口;
- 二进制响应体(图片、字体、gzip,HAR 里标了
encoding: base64)跳过; - 路径常带
/api/v1之类前缀,想去掉就在「去掉路径前缀」里填/api/v1。
范围:普通用户只看自己的
| 身份 | 导出 | 导入 | replace 清空 |
|---|---|---|---|
| 登录用户 | 只导出自己创建的规则 | 归到自己名下、默认私有(挂在自己的命名空间下,不上公开列表) | 只清自己的规则,碰不到别人的 |
| 拥有全部权限的账号 | 全部规则 | 保持原来的可见性与归属 | 清空整站规则 |
| 未登录 | 只导出公开规则 | 按匿名规则处理 | 拒绝(403) |
AI 接入(让 AI 工具直接操作你的接口)
系统内置了 MCP(Model Context Protocol)服务端,端点固定为 /api/mcp(JSON-RPC 2.0 over HTTP)。配好之后,任意支持 MCP 的 AI 工具(Cursor、Claude Desktop、各种自建 Agent)都能直接帮你建接口、改响应、查调用日志,不用再打开网页。
第一步:生成你的 auth key
登录后在控制台的「AI 接入」页点「生成」,会得到一个以 amk_ 开头的密钥,只在这里出现、随时可以重新生成。重新生成会让旧 key 立即失效;不再使用就点「吊销」。
这个 key 等价于你的登录身份:不要提交到仓库、不要发给别人。丢了重新生成一个即可。
第二步:配到 AI 工具里
{
"mcpServers": {
"anymock": {
"type": "streamable-http",
"url": "https://anymock.run/api/mcp",
"headers": { "Authorization": "Bearer amk_xxxxxxxx" }
}
}
}
控制台的「AI 接入」页会直接给出填好地址与 key 的完整配置,复制进去就行。认证三选一,都能识别:Authorization: Bearer amk_xxx 请求头、X-Api-Key: amk_xxx 请求头,或 URL 上的 ?key=amk_xxx。
能做什么
| 工具 | 作用 |
|---|---|
whoami | 看看当前 key 是谁、有多少条规则 |
list_rules / get_rule | 列出 / 查看自己规则(含完整响应配置) |
create_rule / update_rule / delete_rule | 增删改自己的规则 |
list_projects / create_project / update_project / delete_project | 项目的查看、新建、改名改前缀、删除 |
list_datasets / get_dataset / create_dataset / update_dataset / delete_dataset | 数据集的全套:列表、看行数据、新建、改数据、删除 |
list_templates | 看看有哪些现成模板 |
duplicate_rule / set_rule_enabled / set_rule_visibility | 复制一条接口、启用停用、切换公开 / 私有 |
call_rule | 真的调一次自己的接口,返回状态码、响应头与响应体(自检用) |
recent_logs / get_log | 查最近的调用记录 / 看某条日志的完整详情(含请求头、响应头、请求体) |
my_stats | 我自己的统计:规则数、公开私有、启用停用、总命中、近 24 小时调用 |
import_openapi / import_har / import_postman | 从 OpenAPI 3.x / Swagger 2.0 文档(JSON、YAML 都行)、HAR 抓包或 Postman 集合 v2.x 批量生成接口 |
template_cheatsheet | 查模板变量与 Mock.js 语法怎么写(写响应内容前先查它,别猜) |
除了工具,还支持 MCP 的 resources 与 prompts:接口、数据集、项目都能当资源直接读(anymock://rule/<id>、anymock://dataset/<编号>、anymock://project/<id>、anymock://cheatsheet/template);另有四个现成提示词(造接口、导入文档、排查调用、写响应体),在支持 prompts 的客户端里可以直接选。
所有工具只能看到并操作你自己的数据:别人的规则、别人的数据集一律不可见,改删别人的会直接拒绝。也就是说,AI 再怎么折腾,也不会碰到别人的接口或全站配置。
没配 key 会怎样
请求 /api/mcp 不带 key 或 key 无效时,会返回 JSON-RPC 错误码 -32001 并提示去生成 key;用浏览器直接 GET 这个地址则会得到一段自述 JSON(端点说明、支持的方法、怎么认证),方便排查连通性。