技能介绍

问题背景

接口联调与测试时，curl 虽能发请求，但输出杂乱——JSON 响应体缩进混乱，状态码、耗时与响应头混在一起，排查问题得在终端里逐行翻。批量验证接口时，写 shell 循环逐个请求，还得手动解析结果、汇总报告，耗时且易错。CI 流水线里想加接口冒烟测试，却常因输出不结构化、退出码不明确，难以集成到自动化流程。

核心能力与执行流程

工具聚焦命令行场景的接口验证，核心能力包括：

请求支持：覆盖 GET、POST、PUT、DELETE、PATCH 等常见方法，兼容 HTTP/HTTPS（HTTP/1.1）协议；
认证与 Body：支持 Basic Auth、Bearer Token 等基础认证，Body 支持 JSON、表单与纯文本格式；
响应处理：自动格式化 JSON 响应体，展示状态码、耗时与响应头，非 JSON 响应截断至 2000 字符；
批量与超时：通过 --batch 读取 JSON 文件批量执行请求，单请求超时默认 10s（可配置），网络层错误自动重试 2 次。

单请求执行流程：先校验参数（如 URL 需以 http:// 开头），构造请求并预览（自动遮蔽 Authorization 等敏感字段），再发送请求并记录耗时，最后按状态码分类处理响应、格式化输出。批量执行则逐条处理请求，单条失败不中断流程，最终生成包含通过率的汇总报告。

适用边界与注意点

工具不适用于 HTTP/2、gRPC、WebSocket 等协议，也不支持并发执行与请求间依赖编排；不支持 multipart/form-data 文件上传，也不处理业务状态码（4xx/5xx）触发的重试。敏感信息（如 X-Api-Key）会在预览中脱敏，响应体超过 10MB 时会被截断并提示。信息不明确时，工具不会猜测，而是输出 [需核实:字段] 占位符，避免编造数据。错误信息统一带 [E00X] 前缀，退出码分为成功（0）、存在失败（1）、工具自身错误（2），方便脚本解析。