api-testing

API 测试（api-testing）

接口级测试——E2E 之外的另一条执行路径。

• 输入：API 文档（OpenAPI/Swagger）、用例 Schema 中 execution_model 可自动化的接口用例、被测环境信息（base URL、账号/Token）；性能轴（类型矩阵轴 1）移交包 专项移交_性能_*.yaml
• 输出（落盘）：API 测试脚本（pytest + requests，或项目既定技术栈）+ 执行分报告 测试报告_api_{日期}.md（命名按 ../core/report-template.md 头注，条目按其 §3 对齐；qa 断点判据按此文件名核收）；性能承接时另产 k6 压测脚本与压测报告（references/k6-conventions.md）
• 边界：Web UI 流程 → automated-e2e-testing；接口手动用例设计 → test-case-writing

When to Use

• 给定 OpenAPI/Swagger 文档，需要产出并运行接口自动化测试
• 从用例 Schema 中筛出接口级可自动化用例，转换为 API 脚本执行
• 需要覆盖鉴权/越权、幂等、并发写、错误响应等接口层专项
• 给定性能移交包或接口清单，需要生成并运行压测脚本（k6）——按 references/k6-conventions.md

When NOT to Use

• Web UI 交互流程（点击 / 页面状态）→ automated-e2e-testing
• 编写接口的手动测试用例 → test-case-writing
• 端到端流水线 → qa 编排
• 独立压测环境搭建与容量保障 → 运维/专项协作（agent 侧压测承接见 references/k6-conventions.md；外部执行场景按 test-strategy 的移交包）
• Mock Server 搭建 → 开发协作事项，不在本 skill 范围

脚手架（默认 pytest + requests，可替换为项目既定栈）

api-tests/
├── conftest.py            # fixture：base_url、会话/Token、环境配置（环境变量注入，可由 .env 加载，不硬编码）
├── common/
│   └── client.py          # 统一请求封装：日志、超时、鉴权头、断言辅助
├── test_{模块}_{接口}.py   # 一个接口一个文件，test 名沿用 TC 编号
└── requirements.txt

# common/client.py —— 统一请求封装（requests.Session 不支持 base_url，必须显式拼接）
import requests

class Client:
    def __init__(self, base_url: str, token: str):
        self.base_url = base_url.rstrip("/")
        self.s = requests.Session()
        self.s.headers.update({"Authorization": f"Bearer {token}"})

    def request(self, method: str, path: str, **kwargs):
        url = f"{self.base_url}/{path.lstrip('/')}"
        kwargs.setdefault("timeout", 10)
        return self.s.request(method, url, **kwargs)

    def get(self, path, **kw):  return self.request("GET", path, **kw)
    def post(self, path, **kw): return self.request("POST", path, **kw)
    # put / delete / patch 同理扩展

def login(user: str, password: str) -> str:
    """按项目实际登录接口实现（如 POST /login 换 token）——占位，勿直接照抄"""
    raise NotImplementedError("按项目登录接口实现")