接口自动化全字段清单
单表扁平化分 3 层基础必填 通用增强 异步可选兼容普通接口 长耗时异步任务一、基础必填 14 列原始保留不可删减表格字段说明case_id用例唯一编号依赖关联主键module所属业务模块title用例名称、测试点描述enabledtrue/false是否启用执行method请求方式GET/POST/PUT/DELETEpath接口路由路径不含域名headers_json请求头 JSON 字符串空填{}query_jsonurl 拼接参数 JSONGET 参数存放位body_json请求体 JSONPOST/PUT 入参存放位expected_status预期 http 状态码如 200、401expected_contains模糊文本包含断言extract_jsonpathJSONPath 提取变量供下游 depends_on 用例取值depends_on前置依赖 case_id多依赖逗号分隔无填空tags用例标签冒烟 / 回归 / 接口多标签逗号分隔二、通用增强必加 5 列所有自动化项目标配日常接口必用表格字段说明timeout单次请求超时时间 (秒)推荐默认 30env_flag环境标识dev/test/pre/pro用来匹配域名retry_times失败重试次数网络抖动容错默认 0retry_interval重试等待间隔 (秒)默认 2assert_jsonpath_json精准 JSON 字段断言 JSON替代旧 compare例{$.code:0,$.data.id0:true}三、异步长任务可选 4 列大数据、导出、异步任务才启用普通接口全填空表格字段说明polltrue/false是否开启轮询查询任务状态poll_interval单次轮询间隔 (秒)poll_max_wait任务整体最大等待超时 (秒)poll_stop_rule轮询终止 JSONPath 条件例$.taskStatusFINISH四、运维管理可选 3 列项目管理用按需选用表格字段说明priority用例优先级P0 冒烟 / P1 核心回归 / P2 次要功能creator用例编写人remark备注特殊业务逻辑、前置准备说明完整汇总顺序CSV/Excel 排版顺序直接落地plaintextcase_id,module,title,enabled,method,path,headers_json,query_json,body_json,expected_status,expected_contains,extract_jsonpath,depends_on,tags,timeout,env_flag,retry_times,retry_interval,assert_jsonpath_json,poll,poll_interval,poll_max_wait,poll_stop_rule,priority,creator,remark示例一行用例普通 POSTplaintextUSER-001,用户模块,账号密码正常登录,true,POST,/api/login,{Content-Type:application/json},{},{username:test,pwd:123456},200,success,$.data.token,,冒烟,登录,30,test,1,2,{$.code:0},false,0,0,,P0,张三,正式环境账号固定test示例一行用例异步长任务导出plaintextTASK-001,报表模块,导出全量订单报表,true,POST,/api/export/create,{token:{{token}}},{},{},200,taskId