SuperAPI AI 工具集

api-testing

编程与开发

查看项目

更新于 10-16 03:41

技能介绍

用途:为 REST 与 GraphQL API 编写自动化测试,覆盖契约、模式校验、认证流程与性能断言;倡导测契约而非实现,断言响应结构、状态码与响应头。

主要能力:支持 Playwright APIRequestContext(可脱离浏览器独立测试,并与浏览器上下文共享 cookie/存储状态)、Supertest(Node)或 httpx(Python)等进程内测试;模式校验可用 Zod 4(safeParse 后断言 result.success,失败输出 result.error.issues,推荐 z.email()、z.uuid()、z.iso.datetime() 等原生格式)或 AJV + ajv-formats 配合 JSON Schema;支持 schema-as-contract(API 与测试共用同一模式文件);有 OpenAPI/Swagger 时可用 orval 或 openapi-zod-client 自动生成模式,并用 Schemathesis 做规格驱动模糊测试。

测试模式:CRUD 生命周期(describe.serial 创建、读取、更新、删除并验证 404)、认证流程(登录成功、无效凭证 401、过期令牌 401、刷新、权限边界 403)、错误响应(400、422、429 含 retry-after)、响应头(content-type、cache-control、限流头,需无条件断言)、分页、文件上传下载、GraphQL(查询/变更/无效查询加 introspection-diff 快照)、Webhook、性能断言(响应时间预算、载荷大小、并发突发无 5xx)。

探索工具:Bruno(v3.4+,文件式集合,支持 gRPC、OAuth、GraphQL 查询构建器)、Hurl(8.x,纯文本 HTTP 测试与 CI 冒烟检查,支持证书与 JSONPath RFC 9535)、Hoppscotch(基于浏览器的探索)。新项目建议优先文件式工具,便于 PR 审查。

限制与反模式:禁止硬编码令牌;不得针对生产环境测试;不要只测正常路径;响应头断言不可放在条件分支内;测试创建的数据需清理;不要把 API 测试当单元测试(不 mock 数据库,仅 mock 真正第三方);注意 PUT/DELETE 幂等性。完成标准包括每个端点至少一条正常路径与一条错误路径测试、认证流程独立 describe 块、模式校验断言、无条件响应头断言、跨团队端点的契约测试、第三方 mock、CI 套件在测试环境退出码为 0。参考文件与相关技能(contract-testing、playwright-automation、ci-cd-integration、test-strategy)暂未提供具体内容。