用途:这是一个 API 测试助手技能,帮助用户使用 Postman CLI 发送 HTTP 请求。当用户要求“发送请求”“测试端点”“调用 API”“验证端点是否可用”或测试某个 URL 时触发。
主要能力:支持直接指定 URL 发送请求,默认方法为 GET;支持从集合中查找请求,集合采用 v3 文件夹格式,每个集合是包含 *.request.yaml 文件的目录,文件内含 $kind: http-request、url、method、order 等字段。可添加请求头、请求体(内联 JSON 或文件)、表单数据(含文件上传)、Bearer Token、API Key、Basic Auth 认证,并可指定环境文件。还支持重试、自定义超时(默认 300000ms)、保存响应到文件、仅输出响应体、详细输出、调试模式、重定向控制以及前置/后置脚本。
使用方式:基本命令为 postman request <METHOD> "<URL>";请求头用 -H 重复添加;请求体用 -d 或 -d @body.json;表单用 -f;认证用 --auth-bearer-token、--auth-apikey-key/--auth-apikey-value、--auth-basic-username/--auth-basic-password;环境用 -e;重试用 --retry 与 --retry-delay;超时用 --timeout;保存响应用 -o;仅响应体用 --response-only;详细输出用 --verbose;调试用 --debug;重定向用 --redirects-max 或 --redirects-ignore;脚本用 --script-pre-request 与 --script-post-request。执行后需展示确切命令,解析并报告状态码、响应时间和响应体;对 4xx/5xx 错误给出修复建议,如 401/403 建议添加认证头、404 检查路径、500 可能为后端问题、连接被拒检查服务是否运行。
限制与注意:CLI 未安装时提示使用 npm install -g postman-cli 安装;URL 无效、连接被拒或超时需给出对应提示;集合需读取 *.request.yaml 提取方法与 URL;输出中不应暴露或记录令牌等敏感数据。