导入

reqable 可以把第三方 API 平台、接口定义文件和请求记录转换成 Mock 规则。目前支持：

• YApi：深度集成团队自行部署的 YApi
• OpenAPI / Swagger：支持 OpenAPI 3.x、Swagger 2.0 的 JSON / YAML
• Postman：支持 Collection v2.0 / v2.1
• HAR：支持 Chrome DevTools 等工具导出的网络归档
• cURL：粘贴单条 cURL 命令快速创建 Mock

Apifox、Knife4j 等平台可以先导出 OpenAPI 文件，再通过 OpenAPI 入口导入。

使用方式

1. 打开 Mock 列表区域的功能菜单
2. 选择 导入 → 从 API 平台导入
3. 选择来源并上传文件，或粘贴 cURL 命令
4. 确认解析出的接口数量
5. 选择已有分组，或创建新分组
6. 点击导入

所有来源都会转换成 reqable 的统一接口模型，并使用当前 Mock 默认策略生成规则。

URL 补全地址

OpenAPI 文档可能没有配置 servers，Postman Collection 也可能使用未定义的 变量。此时 reqable 使用 OpenAPI / Postman 页面中的 URL 补全地址（可选） 补全 URL。

弹窗会优先读取当前业务页面的域名，你也可以手动改成实际 API 地址，例如：

https://api.example.com

这个地址只用于补全导入结果，不会用于连接平台或下载接口数据。HAR 和 cURL 本身通常已经包含完整请求地址，因此不展示这个选项。

OpenAPI / Swagger

支持：

• OpenAPI 3.x 的 servers、paths、parameters、requestBody 和 responses
• Swagger 2.0 的 host、basePath、schemes、Body 和 Form 参数
• 本地 #/... 引用
• 根据 Schema 的 example、default、enum 和字段类型生成示例
• JSON、表单、文本等常见请求体和响应类型

对于路径参数，优先使用参数示例；没有示例时会生成可编辑的占位值。

Postman Collection

支持 Postman Collection v2.0 / v2.1，包括：

• 嵌套文件夹和 Collection 变量
• URL、Query 和 Headers
• Raw JSON、文本、Form Data、URL Encoded、GraphQL 请求体
• Collection 中保存的响应示例

如果请求没有保存响应示例，reqable 会创建一个空的 JSON 响应，导入后可以继续编辑。

HAR

HAR 导入适合把浏览器中已经发生的真实请求批量转换成 Mock：

1. 在 Chrome DevTools 的 Network 面板中导出 HAR
2. 在 reqable 中选择 HAR
3. 上传 .har 文件

reqable 会读取请求方法、URL、Headers、请求体和响应体，也支持 Base64 编码的响应内容。

cURL

支持常见的 cURL 参数：

• -X / --request
• -H / --header
• -d / --data / --data-raw / --data-binary
• -F / --form
• -G / --get
• -u / --user
• -b / --cookie

示例：

curl 'https://api.example.com/users' \
  -H 'Content-Type: application/json' \
  -d '{"name":"reqable"}'

cURL 本身不包含响应内容，因此导入后默认使用空 JSON 响应。

YApi 深度集成

前置配置

1. 在 设置 → 接口平台集成 → YApi 服务地址 中填写团队自行部署的 YApi 根地址
2. 确保当前账号可以访问目标项目
3. 进入 从 API 平台导入 → YApi

生成方式

选择接口后，可以使用两种方式：

• AI 智能生成：读取 YApi 接口定义和 Schema，由 AI 生成 Mock 响应
• YApi Mock 快速导入：直接读取 YApi 平台已有 Mock，不依赖 AI 配置

单个接口失败不会中断整批任务，完成后会集中展示失败项。

AI 上下文

AI 智能生成会保存 YApi 的响应体 Schema、请求体 Schema 和接口描述。后续在详情页使用 AI 优化响应 时，这些信息会自动作为上下文传入。

Mock 文件恢复

Mock 文件导入 与 API 平台导入是两种不同能力：

• 从 API 平台导入：读取 OpenAPI、Postman、HAR、cURL、YApi，并生成新规则
• Mock 文件导入：恢复 reqable 自己导出的完整 Mock JSON 文件

恢复 Mock 文件时会重新分配规则 ID，避免与已有规则冲突。