SuperAPI AI 工具集

httpie

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:HTTPie 提供直观的命令行与桌面 HTTP 客户端,用于测试、调试和交互 HTTP API,语法贴近人类书写习惯,输出带色彩和格式化 JSON,是 curl 的友好替代方案。

主要能力:支持用简洁语法构造 JSON 请求体与请求头,例如用 Authorization:"Bearer $TOKEN" 传头,用 name="Alice" 传字符串,用 age:=30、active:=true 传非字符串 JSON 值,用 items:='["item_1", "item_2"]' 传数组。可用 == 指定 URL 查询参数(如 status==active、limit==10)。支持命名会话持久化认证信息,如 http --session=staging POST https://api.example.com/auth/login username="admin@example.com" password="SecretPassword2026",后续请求自动复用会话状态。支持多部分表单与文件上传,如 http --form POST https://api.example.com/upload title="Financial Report" document@./annual_report.pdf,并显示进度条与 MIME 类型识别。可调试 GraphQL、REST 和流式 SSE 端点。

使用方式:基本形式为 http 方法 URL 参数。常用实践:用 := 传数字、布尔、数组等非字符串 JSON 值,用 = 传字符串;用 --session 避免重复传递认证头;用 --print=HhBb 控制终端打印哪些头和正文;配合 --json 将输出管道给 jq。

适用场景:终端内 API 原型与脚本调试、重复认证工作流、表单与文件上传测试、GraphQL/REST/SSE 接口联调。

限制与注意:不要在 shell 历史中留明文密码,应通过环境变量或提示输入;指定 URL 查询参数需用 ==,单个 = 表示请求体属性;资源受限容器镜像中若已满足于 curl 可不必使用 HTTPie。开发时可对自签名证书加 --verify=no。常见报错包括 Connection refused(目标端口未监听或被防火墙拦截)、JSON 类型错误(非字符串误用 =)、SSL CERTIFICATE_VERIFY_FAILED(开发自签名证书)。