SuperAPI AI 工具集

api-testing

编程与开发

查看项目

更新于 10-15 21:47

技能介绍

该技能用于编写独立于浏览器的 REST 与 GraphQL 接口测试,提供 TypeScript(Playwright request fixture、Supertest、Zod)与 Java(REST Assured、AssertJ、JSON Schema Validator)两条技术路线。

适用场景:为 REST 或 GraphQL 端点创建测试;校验请求/响应模式(Zod、JSON Schema);测试认证流程(OAuth2、JWT、API Key、Bearer Token);验证错误处理(400、401、403、404、409、422、500);覆盖分页、过滤、排序边界;验证 PUT/DELETE 幂等;服务间契约测试与限流验证。

不适用:浏览器驱动的 UI 流程、交互式浏览器会话或快照、视觉/布局回归、需真实浏览器跨页面的端到端旅程。

前置要求:TypeScript 需 Node.js 18+、@playwright/test 或 supertest、zod;Java 需 Java 21+、REST Assured 5.x、AssertJ、Jackson、json-schema-validator。核心原则为每个响应都做模式校验、覆盖全部 HTTP 状态码、强制测试认证的 401/403、数据驱动测试、尽量无状态与数据清理。

需警惕:只断言状态码不校验响应体、硬编码令牌、测试间共享可变状态、跳过认证测试、只测正常路径。使用时注意令牌过期、限流导致的抖动、模式过严(可用 .passthrough() 或 additionalProperties: true)以及慢端点超时等问题。资料暂未提供收费、价格等具体信息。