HTTPie 人性化 HTTP 命令行客户端

技能概述

本技能帮助用户通过命令行发送 HTTP 请求，调试 API 接口，适用于以下场景：

• REST API 调试: 发送 GET/POST/PUT/DELETE 等各类 HTTP 请求
• 接口测试: 快速验证 API 端点的请求与响应
• 文件上传下载: 通过命令行进行文件传输
• 身份认证: 支持 Basic、Bearer Token、Digest 等多种认证方式
• 会话管理: 跨请求保持 Cookie 与认证状态
• 格式化输出: 自动语法高亮显示 JSON、XML 响应体

主要特点: 语法简洁、自动格式化、彩色输出、内置 JSON 支持、比 curl 更易读写

使用流程

AI 助手将引导你完成以下步骤：

1. 安装 HTTPie（如未安装）
2. 构建 HTTP 请求（方法、URL、请求头、请求体）
3. 执行请求并查看格式化响应
4. 根据响应调整请求参数
5. 将成功的命令保存为可复用脚本

关键章节导航

• 安装指南
• 快速开始
• 高级用法
• 常见问题

AI 助手能力

当你向 AI 描述请求需求时，AI 会：

• 自动识别请求类型（GET/POST/PUT/PATCH/DELETE）
• 根据描述构建正确的请求头和请求体
• 执行请求命令并解析响应
• 识别常见 HTTP 错误状态码并给出建议
• 自动处理 JSON 数据序列化
• 管理认证令牌和会话 Cookie
• 将复杂请求转换为可读的 HTTPie 命令

核心功能

• 支持全部 HTTP 方法（GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS）
• 自动 JSON 请求体序列化与响应格式化
• 彩色语法高亮（请求头、响应头、响应体）
• 内置多种认证方式（Basic、Digest、Bearer）
• 持久化 Session 管理（跨请求 Cookie）
• 文件上传与二进制下载支持
• HTTPS 与 SSL 证书验证
• 代理支持（HTTP/HTTPS/SOCKS）
• 离线模式（仅打印请求不发送）
• 与 curl 命令互转

命令速查表

基础请求

# GET 请求
http GET https://api.example.com/users

# 简写（默认 GET）
http https://api.example.com/users

# POST JSON（自动推断 Content-Type: application/json）
http POST https://api.example.com/users name="张三" age:=25

# PUT 更新
http PUT https://api.example.com/users/1 name="李四"

# PATCH 部分更新
http PATCH https://api.example.com/users/1 email="[email protected]"

# DELETE 删除
http DELETE https://api.example.com/users/1

请求参数与请求头

# URL 查询参数（== 语法）
http https://api.example.com/search q=="hello world" page==2

# 自定义请求头（: 语法）
http https://api.example.com/users "Authorization: Bearer mytoken123"

# 多个请求头
http https://api.example.com/data "X-API-Key: abc123" "Accept: application/json"

认证

# Basic 认证
http -a username:password https://api.example.com/protected

# Bearer Token
http https://api.example.com/me "Authorization: Bearer \x3Ctoken>"

# Digest 认证
http --auth-type=digest -a user:pass https://api.example.com/secure

输出控制

# 仅显示响应体
http --body https://api.example.com/users

# 仅显示响应头
http --headers https://api.example.com/users

# 显示请求+响应（调试用）
http --verbose https://api.example.com/users

# 安静模式（无输出，只看退出码）
http --quiet https://api.example.com/health

# 保存响应到文件
http https://api.example.com/file.pdf > file.pdf

安装要求

• Python 3.7+ 或直接使用独立二进制包
• 无其他强制依赖

许可证

BSD-3-Clause License

项目链接

• GitHub: https://github.com/httpie/cli
• 官网: https://httpie.io
• 文档: https://httpie.io/docs/cli