第1章 先看懂接口自动化框架全景

本章目标

看完本章，你会知道这套框架“做了什么、怎么跑起来、你要改哪里”。

1. 什么是接口自动化

一句话：把“手工调接口 + 手工看返回 + 手工比对结果”变成程序自动执行。

这套项目里，你只要写 YAML 测试数据，框架会自动完成：

• 发请求
• 做断言
• 提取 token
• 生成报告
• 接入 Jenkins 自动跑

2. 这套项目的核心执行链路

data/*.yaml -> test_api.py -> common/request_handler.py + common/assertion.py
           -> report/html_report/logs -> Jenkins 定时执行与邮件通知

3. 你最常接触的 5 个位置

• data/：写测试用例（最常改）
• config/config.yaml：配环境地址
• run.py：本地一键执行
• html_report/：看报告
• logs/：排错

4. 你可以先不管的内容

刚开始不用改：

• common/*.py（框架核心能力）
• Jenkinsfile（先本地跑通再接 CI）
• tools/（Allure/JRE 便携工具）

5. 新手学习顺序

1. 先把本地跑通（第2章）
2. 再写第一个 YAML 用例（第4章）
3. 然后学 token 参数关联（第5章）
4. 最后再上 Jenkins（第8-10章）

本章验收标准

• 你能说清楚 data -> run.py -> 报告 这条链路
• 你知道自己目前主要改 data/ 和 config/config.yaml
• 你知道报错优先看 logs/