Mock接口管理
AngusTester Mock接口管理模块支持灵活配置多种响应模式，实现接口行为模拟与请求代理。
一、接口基础操作
1. 创建Mock接口
操作说明：定义新的Mock接口规范
操作步骤：
Mock服务 → 接口点击「添加接口」
- 填写基础信息：
- 路径（如
/api/login） - 方法（GET/POST等）
- 描述（功能说明）
- 路径（如
- 配置响应内容：
- 状态码（200/404等）
- 响应体（JSON/XML/TEXT）
- 响应头（Content-Type等）
⚠️ 路径+方法需全局唯一
2. 批量导入接口
操作说明：通过脚本文件批量创建接口
操作步骤：
添加接口▼选择「导入接口」
- 上传文件（JSON/YAML）
- 设置冲突策略：
- 覆盖（更新同名接口）
- 跳过（保留原接口）
3. 克隆与导出
操作说明：复用或备份接口配置
操作步骤：
- 克隆接口：
- 接口行点击「克隆」
- 自动创建副本（修改路径防冲突）
- 导出接口：
- 点击「导出」按钮
- 下载JSON格式脚本
二、接口调试与测试
1. 实例配置同步
操作说明：强制更新运行中接口配置
操作步骤：
接口列表点击「刷新实例接口」
- 系统自动：
- 重载最新配置
- 保持现有连接
耗时约3秒
2. 请求测试验证
操作说明：实时验证接口响应准确性
操作步骤：
右侧点击「测试请求」- 发送请求查看响应：
- 状态码（绿色/红色标识）
- 响应时间（ms）
- 响应体（格式化展示）
❗ 响应头含XC-Mock-Error表示配置错误
3. 请求代理配置
操作说明：解决跨域限制问题
操作步骤：
测试面板点击「代理」图标- 选择预置代理节点
⚠️ 需先在系统配置中设置代理
三、响应配置管理
1. 随机内容响应
操作说明：动态生成Mock数据
操作步骤：
响应配置填写Mock函数：
2. 条件匹配响应
操作说明：根据请求参数返回不同响应
操作步骤：
- 添加多个响应
- 配置匹配规则：
- 优先级（数字越小优先级越高）
- 条件（Header/Query/Body）
- 设置对应响应内容
⚠️ 未匹配时返回默认响应
3. 延迟响应配置
操作说明：模拟网络延迟场景
操作步骤：
响应配置设置延迟参数：- 固定延迟（毫秒）
- 随机范围（10-200ms）
4. 异常状态码响应
操作说明：模拟服务端错误
操作步骤：
响应配置设置状态码：- 4xx（客户端错误）
- 5xx（服务端错误）
5. 文件下载响应
操作说明：返回二进制文件内容
操作步骤：
响应体点击「插入文件」- 选择本地文件自动转Base64
⚠️ 文件大小≤10MB
6. 请求回推功能
操作说明：异步转发请求到真实接口
操作步骤：
响应配置开启「回推」开关- 配置目标URL和参数
四、维护管理操作
1. 响应管理
操作说明：维护接口多响应配置
操作步骤：
- 添加响应：点击「添加响应」
- 删除响应：
- 响应卡片点击「删除」
- 确认移除
2. 接口删除
操作说明：清理无效接口
操作步骤：
接口列表选中目标接口- 点击「删除」图标
- 二次确认操作
3. 示例库导入
操作说明：快速获取标准示例
操作步骤：
添加接口▼选择「导入示例」- 系统自动创建内置接口示例
MockApi字段信息
| 参数 | 字段名 | 类型 | 必填 | 长度限制 | 说明 |
|---|---|---|---|---|---|
| ID | id | bigint | 条件 | / | 唯一标识符； 修改时必须 |
| Mock服务ID | mockServiceId | long | 是 | / | 关联Mock服务唯一标识 |
| 接口名称 | summary | string | 是 | ≤400 | 接口功能摘要 |
| 详细描述 | description | string | 否 | ≤20000 | 接口详细描述 |
| HTTP方法 | method | enum | 是 | / | HTTP方法， 如：GET |
| 接口端点 | endpoint | string | 是 | ≤800 | 接口访问路径 |
| 项目ID | projectId | long | 只读 | / | 所属项目ID |
| 接口来源 | source | enum | 只读 | / | 来源， 如：手动创建 |
| 导入来源 | importSource | enum | 只读 | / | 导入来源， 如：OpenAPI |
| 关联项目ID | assocProjectId | long | 只读 | / | 关联项目ID |
| 关联项目名称 | assocProjectName | string | 只读 | / | 关联项目名称 |
| 关联接口ID | assocApisId | long | 只读 | / | 关联接口ID |
| 关联接口名称 | assocApisName | string | 只读 | / | 关联接口名称 |
| Mock服务名称 | mockServiceName | string | 只读 | / | 关联Mock服务名称 |
| Mock服务域名 | mockServiceDomainUrl | string | 只读 | / | Mock服务域名地址 |
| Mock服务主机地址 | mockServiceHostUrl | string | 只读 | / | Mock服务主机地址 |
| 请求次数 | requestNum | long | 只读 | / | 接口请求总次数 |
| 推送请求次数 | pushbackNum | long | 只读 | / | 推送请求次数 |
| 模拟错误次数 | simulateErrorNum | long | 只读 | / | 模拟错误响应次数 |
| 成功次数 | successNum | long | 只读 | / | 请求成功次数 |
| 异常次数 | exceptionNum | long | 只读 | / | 请求异常次数 |
| 操作不一致标记 | inconsistentOperation | boolean | 只读 | / | 接口操作是否不一致 |
| 关联接口删除状态 | assocApisDeleted | boolean | 只读 | / | 关联接口是否已删除 |
| 实际接口方法 | apisMethod | enum | 只读 | / | 关联接口实际HTTP方法 |
| 实际接口端点 | apisEndpoint | string | 只读 | / | 关联接口实际访问路径 |
| 响应列表 | responses | list | 只读 | / | Mock响应配置列表 |
| 租户 ID | tenantId | long | 只读 | / | 所属租户 ID |
| 创建人ID | createdBy | long | 只读 | / | 接口创建人ID |
| 创建人姓名 | createdByName | string | 只读 | / | 创建人姓名 |
| 创建时间 | createdDate | datetime | 只读 | / | 接口创建时间 |
| 最后修改人ID | lastModifiedBy | long | 只读 | / | 最后修改人ID |
| 最后修改人姓名 | lastModifiedByName | string | 只读 | / | 最后修改人姓名 |
| 最后修改时间 | lastModifiedDate | datetime | 只读 | / | 最后修改时间 |
响应列表字段（responses）
| 参数 | 字段名 | 类型 | 说明 |
|---|---|---|---|
| 响应名称 | name | string | 响应配置名称 |
| 请求匹配条件 | match | object | 请求匹配规则配置 |
| 响应内容 | content | object | Mock响应内容配置 |
| 推送配置 | pushback | object | 请求推送配置 |
| 匹配异常响应标记 | matchExceptionResponse | boolean | 是否匹配异常响应 |
接口来源（source）
| 枚举值 | 说明 |
|---|---|
CREATED | 用户手动创建的接口 |
ANGUS_IMPORT | 通过AngusTester文件导入的接口 |
COPY_APIS | 复制已有接口生成的副本 |
ASSOC_APIS | 关联接口生成的Mock接口 |
导入来源（importSource）
| 枚举值 | 说明 |
|---|---|
OPENAPI | 从OpenAPI规范文件导入的接口 |
POSTMAN | 从Postman集合文件导入的接口 |
ANGUS | 从AngusTester规范文件导入的接口 |
HTTP方法（method）
| 枚举值 | 说明 |
|---|---|
GET | 请求获取指定资源 |
POST | 向指定资源提交数据 |
PUT | 替换目标资源全部内容 |
DELETE | 删除指定资源 |
PATCH | 对资源进行部分更新 |
OPTIONS | 获取服务器支持的通信选项 |
HEAD | 获取资源的响应头元信息 |