SuperAPI AI 工具集

w-api-test

测试与质量

查看项目

更新于 10-15 12:36

技能介绍

w-api-test 是 blockmatic/basilic-skills 中的一项技能,主要用于为已有测试装置补充 API 测试,从公开 HTTP 接口层面验证服务行为。

用途 该技能的目标是新增能够模拟公开 HTTP 行为的 API 测试,并让这些测试运行在仓库已有的测试装置(harness)之上。它面向的是端点级别的接口验证,而非内部实现细节。

主要能力

  • 通过公开接口测试端点,使用本仓库的 API 装置或 Playwright 装置。
  • 覆盖所请求的操作、授权拒绝(authz denials)以及符合契约结构的响应。
  • 与已有的 *.test.ts 或 e2e 规格(specs)以及 API 测试 MDX 文档配合使用。

使用方式

  1. 阅读 API 测试的 MDX 文档以及现有的 *.test.ts 或 e2e 规格文件。
  2. 针对请求的操作、授权拒绝情形和契约响应形状编写测试覆盖。
  3. 使用 package scripts 中提供的沙箱或本地服务器运行测试,不要访问生产环境,不要硬编码密钥。
  4. 测试完成后清理所创建的资源。
  5. 运行文档中记录的 API 或 e2e 命令来执行这些测试。
  6. 如果行为或命令发生变化,参考 /w-docs 文档。

适用场景

  • 为后端服务补充接口契约测试与权限校验测试。
  • 在本地或沙箱环境中验证 HTTP 端点的公开行为。
  • 在已有 API 或 Playwright 测试装置基础上扩展测试覆盖。

限制与注意事项

  • 明确不得访问生产环境。
  • 不得硬编码密钥。
  • 需依赖仓库内已有的测试装置、MDX 文档与测试命令;具体命令以实现仓库为准。

当前资料未提供的信息:该技能的安装命令、支持的平台、是否收费及价格、详细实现机制、官方文档全文等。