api-testing

API 测试（api-testing）

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

• 输入：API 文档（OpenAPI/Swagger）、用例 Schema 中 execution_model 可自动化的接口用例、被测环境信息（base URL、账号/Token）
• 输出（落盘）：API 测试脚本（pytest + requests，或项目既定技术栈）+ 运行结果（报告条目按 ../core/report-template.md 对齐）
• 边界：Web UI 流程 → automated-e2e-testing；接口手动用例设计 → test-case-writing；性能压测 → 专项工具（k6/locust，见 test-strategy 的 handoff）

When to Use

• 给定 OpenAPI/Swagger 文档，需要产出并运行接口自动化测试
• 从用例 Schema 中筛出接口级可自动化用例，转换为 API 脚本执行
• 需要覆盖鉴权/越权、幂等、并发写、错误响应等接口层专项

When NOT to Use

• Web UI 交互流程（点击 / 页面状态）→ automated-e2e-testing
• 编写接口的手动测试用例 → test-case-writing
• 端到端流水线 → qa 编排
• 接口压测 / 限流摸底 → k6 / locust 专项
• 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，必须显式拼接）
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("按项目登录接口实现")

# conftest.py 关键 fixture
@pytest.fixture(scope="session")
def client():
    base_url = os.environ["API_BASE_URL"]          # 环境与账号不硬编码，走环境变量
    token = login(os.environ["API_USER"], os.environ["API_PASSWORD"])
    return Client(base_url, token)