用途:把 API 定义自动转成生产可用的测试用例,覆盖 happy path、边界条件、错误处理与鉴权,适用于需要为接口快速补齐自动化测试的开发和测试场景。
支持的输入:OpenAPI 3.x(YAML/JSON)、Swagger 2.0、Postman Collection v2.x、原始 curl 命令、纯英文接口描述、HTTP 请求/响应示例,以及 Express.js、FastAPI、Spring 等路由/控制器代码。
支持的测试框架:Python 用 pytest + requests 或 httpx;JavaScript/TypeScript 用 Jest、Mocha/Chai、Supertest;Java 用 JUnit 5 + RestAssured;Go 用 testing + net/http/httptest;语言无关可用 Newman、k6 或普通 .http 文件。未指定框架时,Python API 默认 pytest,JS/TS API 默认 Jest。
工作流程:先解析定义,抽取端点、请求头/查询/路径参数与请求体 schema、响应状态码与 schema、鉴权方式及约束条件;定义不完整时会先向用户确认。再为每个端点生成正常路径、参数校验、鉴权/授权、边界与集成流程测试,按框架输出完整可运行代码,附带摘要表、安装与运行说明及覆盖缺口。
特殊模式:--mock 模式用 responses、nock 或 msw 模拟 HTTP 调用;--load 模式输出 k6 脚本;--contract 模式生成 Pact 契约测试桩。
质量要求:每个文档化状态码至少一个测试,必填字段缺失需有测试,鉴权端点需有未认证测试,参数化减少重复,测试命名遵循 verb_condition_expectation。参考文件含各框架模板与 OpenAPI 解析指南。
限制:输入定义缺失鉴权方式、错误 schema、环境地址、副作用或框架偏好时需用户补充;无法测试的场景会列为覆盖缺口。平台执行可借助 TestMu AI HyperExecute,输出后可询问是否生成测试用例 API 文档,若未安装 API Documentation 技能需先安装。原文未提供定价与平台细节。