如何将应用的 API 调用转为 API 测试?
在使用应用时录制调用,查看列表,再根据保留的调用生成测试。Verdict System LLC 出品的 Nexus StudioQA 中的 Nexus Recorder 可将页面发出的调用录制为 REST 或 GraphQL 测试,排除身份验证和 Cookie 请求头,并将疑似包含敏感信息的字段转换为环境变量。整个过程都在你自己的计算机上运行。
最后更新:
作者:Verdict System LLC 的 Nexus StudioQA 团队。
录制是如何进行的?
- 在 Nexus Recorder 中,逐步点击完成登录、结账等流程,同时录制页面发出的调用。
- 在写入任何测试之前,审核界面会列出每个调用的方法、路径、状态、类别,以及纳入或排除它的原因。
- 业务、身份验证、读取和状态变更调用默认纳入测试套件。遥测信标、第三方主机、资源和预检请求默认排除,你可以勾选其中任意一项,将其重新纳入。
- 流程会将某个响应中的值传递给后续请求,例如登录返回的令牌。
可以从录制内容生成什么?
- 生成测试会写入 API 测试套件。
- 生成 OpenAPI会写入一份包含类型和状态码的 OpenAPI 3.1 草稿,不包含任何录制的值。
- 负载测试会将同一组调用作为负载计划打开。
哪些内容不会写入测试文件?
| 录制捕获的内容 | 测试文件中写入的内容 |
|---|---|
| 身份验证和 Cookie 请求头 | 排除 |
| 名称疑似涉及敏感信息的字段 | 环境变量,列在脱敏项下 |
| 任意字段中的 JWT、提供商密钥和银行卡号 | 根据值进行脱敏,而不只根据字段名 |
| 遥测、第三方主机、资源和预检请求 | 默认排除 |
测试运行时,其身份验证令牌只会发送到 API_BASE_URL 中指定的源,绝不会发送到录制中出现的其他主机。
如何判定 API 测试结果?
它们像其他测试一样从 Patrol 运行,每个端点都会生成自己的证据文件夹。API 测试没有沙盒:首次点击就会实际运行。它们有独立的 API 判定结果:所有断言均成立且响应结构与上次录制一致时为 API_SECURE,重试通过时为 API_FLAKY,通过但结构发生变化时为 API_DRIFTED,并会列出每个新增、删除或类型变更的字段。API 模式漂移展示了一次实际运行中的漂移。
有哪些局限?
- 录制内容仅包含录制期间页面发出的调用。流程从未访问的端点不会包含在内。
- 录制可写入 REST 和 GraphQL 测试。SOAP 测试需要手动创建,将 XML 作为文本发送,并用文本规则检查。
- API 测试使用 Studio 自有的格式,因此迁移到其他运行器时需要重写。Recorder 写入的浏览器测试仍采用标准的 Playwright 或 Selenium 格式。
- 信任生成的测试之前,请先审核:录制只知道应用做了什么,而不知道它应该做什么。
在哪里可以看到?
Studio 导览展示了 Nexus Recorder,API 模式漂移则通过可运行的示例解释 API 判定结果。免费试用版可在你自己的应用上运行同一引擎。