接口调试 命令行速测
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a10ab3ad/cli-command-tester。
技能介绍
要解决什么问题
联调时你往往不想为了打一个 GET 或 POST 去开 Postman,也不想在脚本里临时写 curl 再调格式。本技能把 HTTP 命令行速测 收敛成固定流程:在对话里给出 URL、方法、头和 body,由技能按约定执行并返回可读结果,适合后端验逻辑、前端看返回、测试造边界请求。
核心能力与执行方式
技能围绕「构造请求 → 发 HTTPS/HTTP → 展示响应」展开,能力边界在文档里写得很清楚:
- 方法与 URL:支持
GET/POST/PUT/DELETE/PATCH/HEAD/OPTIONS - 请求头:例如
-H "Authorization: Bearer token"、自定义Content-Type - 请求体:JSON、表单、原始文本,如
-d '{"name":"test"}' - 查询参数:
-p "page=1&size=20"等,查询串会做编码 - 响应处理:JSON 自动缩进与高亮,过长内容可截断;可用
-o response.json落盘 - 其它:超时
-t、跟随重定向-L等
典型用法形态类似:cli POST https://api.example.com/users 或带头、体的组合。执行上技能会读取参数或交互输入,跑完核心逻辑后输出结构化结果;失败时会给非零退出码、明确错误信息与排查建议(缺依赖、网络异常等),并带上 error context,不悄悄吞错。
运行环境要求 Python 3.9+,文档称开箱即用、无额外依赖;需要真实访问接口时网络要通。
边界与注意点
下列情况不要指望本技能包办:
- 仅 HTTP/HTTPS,不支持 WebSocket
- 不支持文件上传,请求体限于文本
- 无 Cookie 持久化,每次调用是独立会话
- 无内置代理 / 双向 TLS,代理需在系统层配置,证书走常规 HTTPS 校验
另外文档中的用户协议与免责声明表明:内容仅供学习参考,专业决策需咨询持证人士;使用结果由使用者自行承担。把技能当终端侧的快速探针,而不是替代完整测试平台或安全审计工具,预期会更准确。
使用场景
- 后端新增路由后,在终端用 `POST` 与 JSON body 快速核对状态码和返回字段是否与设计一致。
- 前端联调时带上 `Authorization` 头执行 `GET`,检查分页查询参数编码后的列表 JSON 结构。
- 测试需要发送含边界字段的 `PUT` 或 `DELETE` 请求,并阅读自动格式化后的错误响应体。
- 部署后从 shell 对 health 地址执行带超时与 `-L` 的 `GET`,确认重定向与可达性。
适合人员
- 维护 REST 接口的后端工程师,需要在对话里复现带自定义请求头的线上失败请求。
- 正在对接后端契约的前端工程师,要快速查看某 HTTPS 地址在特定 query 下的 JSON 返回。
- 负责接口用例的测试工程师,需要构造多种 HTTP 方法与文本 body 观察非 2xx 时的响应格式。
- 值班运维或 SRE,需在无图形界面的环境做健康检查并把响应用 `-o` 保存为文件备查。