作者 | Eason
来源 | 程序员巴士
HTTPie是一个命令行 HTTP 客户端。它的目标是使 CLI 与 Web 服务的交互尽可能人性化。HTTPie 设计用于测试、调试以及通常与 API 和 HTTP 服务器交互。http 和 https 的命令允许创建和发送任意 HTTP 请求。HTTPie 整体采用简单自然的语法，并提供格式化和彩色输出。
主要特点
富有表现力和直观的语法
格式化和彩色终端输出
内置 JSON 支持
表格和文件上传
HTTPS、代理和身份验证
任意请求数据
自定义标题
持续Sessions
类似 Wget 的下载
Linux、macOS、Windows 和 FreeBSD 支持
插件
文档
测试覆盖率
安装
macOS
Homebrew
安装 Homebrew 可以看它的安装教程[1].
安装 httpie
brew update
brew install httpie
升级 httpie
brew update
brew upgrade httpie
Windows
Chocolatey
安装 Chocolatey 可以看它的 安装教程[2].
安装 httpie
choco install httpie
升级 httpie
choco upgrade httpie
Linux
Snapcraft (Linux)
安装 Snapcraft 可以看它的 安装教程[3].
安装 httpie
snap install httpie
升级 httpie
snap refresh httpie
Debian and Ubuntu
也适用于其他 Debian 衍生发行版，如 MX Linux、Linux Mint、deepin、Pop!_OS、KDE neon、Zorin OS、elementary OS、Kubuntu、Devuan、Linux Lite、Peppermint OS、Lubuntu、antiX、Xubuntu 等。
安装 httpie
apt update
apt install httpie
升级 httpie
apt update
apt upgrade httpie
FreeBSD
安装 httpie
pkg install www/py-httpie
升级 httpie
pkg upgrade www/py-httpie
安装测试版本
大家还可以直接从masterGitHub 上的分支安装最新的未发布开发版本。它是未来稳定版本的正在进行中的工作，因此体验可能不会那么顺利。
大家可以使用以下命令在 Linux、macOS、Windows 或 FreeBSD 上安装pip：
python -m pip install --upgrade https://github.com/httpie/httpie/archive/master.tar.gz
或者在 macOS 和 Linux 上，使用 Homebrew：
brew uninstall --force httpie
brew install --HEAD httpie
甚至在 macOS 和 Linux 上，使用 Snapcraft：
snap remove httpie
snap install httpie --edge
验证是否拥有带有后缀的当前开发版本标识符.dev0，例如：
http --version
#3.0.3.dev0
用法
Hello World:
https httpie.io/hello
获取用法:
http [flags] [METHOD] URL [ITEM [ITEM]]
http --help
举例
自定义HTTP 方法、HTTP Header和JSON数据：
http PUT pie.dev/put X-API-Token:123 name=John
提交 forms：
http -f POST pie.dev/post hello=World
查看使用输出选项之一发送的请求：
http -v pie.dev/get
在不发送的情况下通过使用离线模式构建和打印请求：
http --offline pie.dev/post hello=offline
使用重定向上传文件：
http pie.dev/post < files/data.json
下载文件并通过重定向输出保存：
http pie.dev/image/png > image.png
使用命名Sessions使对同一主机的请求之间的通信的某些方面保持持久：
http --session=logged-in -a username:password pie.dev/get API-Key:123
http --session=logged-in pie.dev/headers
设置自定义Host Header以解决丢失的 DNS 记录：
http localhost:8000 Host:example.com
HTTP方法
HTTP 方法的名称就在 URL 参数之前：
http DELETE pie.dev/delete
这看起来与发送的实际相似Request-Line：
DELETE /delete HTTP/1.1
除了标准方法（GET、POST、HEAD、PUT、PATCH、DELETE等）之外，还可以使用自定义方法名称，例如：
http AHOY pie.dev/post
对于请求方法可以包含正文没有任何限制，发送一个空POST请求：
http POST pie.dev/post
还可以发出GET包含正文的请求：
http GET pie.dev/get hello=world
可选GET和POST
该METHOD参数是可选的，当你不指定它时，HTTPie 默认为：
GET: 对于没有正文的请求
POST: 对于带有正文的请求
这里我们没有指定任何请求数据，所以两个命令将发送相同的GET请求：
http GET pie.dev/get
http pie.dev/get
另一方面，我们可以通过两个命令将发出相同的POST请求：
http POST pie.dev/post hello=world
http pie.dev/post hello=world
请求网址
HTTPie 执行请求所需的唯一信息是 URL。
默认方案是http://并且可以从参数中省略：
http example.org
#→ http://example.org
HTTPie 还安装了一个https可执行文件，其中默认方案是https://：
https example.org
#→ https://example.org
当把 URL 粘贴到终端时，甚至可以保留://URL 参数中的位，以将 URL 快速转换为 HTTPie 调用，只需在协议名称后添加一个空格即可。
https ://example.org #→ https://example.org
网址快捷方式localhost
支持类似 curl 的 localhost 简写。这意味着，例如，:3000将扩展为http://localhost:3000 如果省略端口，则假定端口 80。
http :/foo
GET /foo HTTP/1.1
Host: localhost
http :3000/bar
GET /bar HTTP/1.1
Host: localhost:3000
http :
GET / HTTP/1.1
Host: localhost
JSON
JSON 是现代 Web 服务的通用语，也是HTTPie 默认使用的隐式内容类型。
简单的例子：
http PUT pie.dev/put name=John email=john@example.org
PUT / HTTP/1.1
Accept: application/json, */*;q=0.5
Accept-Encoding: gzip, deflate
Content-Type: application/json
Host: pie.dev{"name": "John","email": "john@example.org"
}默认行为
如果命令中包含一些数据请求项，则默认将它们序列化为 JSON 对象。HTTPie 还自动设置以下Header，这两个Header都可以被覆盖：
Content-Type : application/json
Accept : application/json, /;q=0.5
显式 JSON
无论是否正在发送数据，都可以使用--json, -j显式设置Accept为（这是通过通常的Header符号设置Header的快捷方式：） 。此外，即使响应不正确或未知，HTTPie 也会尝试检测 JSON 响应。application/jsonhttp url Accept:'application/json, /;q=0.5'Content-Typetext/plain
非字符串 JSON 字段
非字符串 JSON 字段使用:=分隔符，它允许将任意 JSON 数据嵌入到生成的 JSON 对象中。此外，文本和原始 JSON 文件也可以使用=@和嵌入到字段中:=@：
http PUT pie.dev/put \name=John \ # String (default)age:=29 \ # Raw JSON — Numbermarried:=false \ # Raw JSON — Booleanhobbies:='["http", "pies"]' \ # Raw JSON — Arrayfavorite:='{"tool": "HTTPie"}' \ # Raw JSON — Objectbookmarks:=@files/data.json \ # Embed JSON filedescription=@files/text.txt # Embed text filePUT /person/1 HTTP/1.1
Accept: application/json, */*;q=0.5
Content-Type: application/json
Host: pie.dev{"age": 29,"hobbies": ["http","pies"],"description": "John is a nice guy who likes pies.","married": false,"name": "John","favorite": {"tool": "HTTPie"},"bookmarks": {"HTTPie": "https://httpie.org",}
}:=/:=@语法是 JSON 特定的。大家可以将请求切换为--formor --multipart，并且字符串、浮点数和数字值将继续被序列化（作为字符串形式的值）。但是，其他 JSON 类型不允许使用--form或--multipart。
形式
提交表单与发送JSON请求非常相似。通常唯一的区别是添加--form, -f选项，它确保数据字段被序列化为，并Content-Type设置为application/x-www-form-urlencoded; charset=utf-8. 可以通过配置文件使表单数据成为隐式内容类型而不是 JSON。
常规表格
http --form POST pie.dev/post name='John Smith'
POST /post HTTP/1.1
Content-Type: application/x-www-form-urlencoded; charset=utf-8name=John+Smith文件上传表格
如果存在一个或多个文件字段，则序列化和内容类型为multipart/form-data：
http -f POST pie.dev/post name='John Smith' cv@~/files/data.xml
上面的请求与提交以下 HTML 表单相同：
<form enctype="multipart/form-data" method="post" action="http://example.com/jobs"><input type="text" name="name" /><input type="file" name="cv" />
</form>请注意，@它用于模拟文件上传表单字段，而=@只是将文件内容嵌入为常规文本字段值。
上传文件时，它们的内容类型是从文件名中推断出来的。大家可以手动覆盖推断的内容类型：
http -f POST pie.dev/post name='John Smith' cv@'~/files/data.bin;type=application/pdf'
multipart/form-data即使没有任何文件也要执行请求，请使用--multipart代替--form：
http --multipart --offline example.org hello=world
POST / HTTP/1.1
Content-Length: 129
Content-Type: multipart/form-data; boundary=c31279ab254f40aeb06df32b433cbccb
Host: example.org--c31279ab254f40aeb06df32b433cbccb
Content-Disposition: form-data; name="hello"world
--c31279ab254f40aeb06df32b433cbccb--文件上传总是流式传输以避免大文件的内存问题。
默认情况下，HTTPie 使用随机唯一字符串作为多部分边界，但大家可以使用它--boundary来指定自定义字符串：
http --form --multipart --boundary=xoxo --offline example.org hello=world
POST / HTTP/1.1
Content-Length: 129
Content-Type: multipart/form-data; boundary=xoxo
Host: example.org--xoxo
Content-Disposition: form-data; name="hello"world
--xoxo--如果指定自定义Content-Type Header而不包括边界位，HTTPie 将自动将边界值（显式指定或自动生成）添加到 Headers：
http --form --multipart --offline example.org hello=world Content-Type:multipart/letter
POST / HTTP/1.1
Content-Length: 129
Content-Type: multipart/letter; boundary=c31279ab254f40aeb06df32b433cbccb
Host: example.org--c31279ab254f40aeb06df32b433cbccb
Content-Disposition: form-data; name="hello"world
--c31279ab254f40aeb06df32b433cbccb--HTTP Headers
要设置自定义 Headers，可以通过使用以下Header:Value符号：
http pie.dev/headers User-Agent:Bacon/1.0 'Cookie:valued-visitor=yes;foo=bar' \X-Foo:Bar Referer:https://httpie.org/GET /headers HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Cookie: valued-visitor=yes;foo=bar
Host: pie.dev
Referer: https://httpie.org/
User-Agent: Bacon/1.0
X-Foo: Bar默认请求headers
HTTPie 设置了几个默认Header：
GET / HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
User-Agent: HTTPie/<version>
Host: <taken-from-URL>其中任何一个都可以被覆盖，其中一些可以取消设置。
具有相同名称的多个Header Value
如果请求是使用共享相同名称的多个Header发送的，则 HTTPie 将单独发送它们。
http --offline example.org Cookie:one Cookie:two
GET / HTTP/1.1
Cookie: one
Cookie: two也可以传递单个header value pair，其中值是Header Value的逗号分隔列表。然后客户端会将其作为单个header发送。
http --offline example.org Numbers:one,two
GET / HTTP/1.1
Numbers: one,two另外，如果当前Sessions包含任何header，则它们将在发送请求时被单独的命令覆盖，而不是被连接在一起。
限制响应Header
这些--max-headers=n选项允许控制 HTTPie 在放弃之前读取的Header数量（默认值0，即没有限制）。
http --max-headers=100 pie.dev/get
Cookies
HTTP 客户端将 cookie 作为常规HTTP Header发送到服务器。这意味着，HTTPie 不提供任何用于指定 cookie 的特殊语法——使用通常的Header:Value符号：
发送一个 cookie：
http pie.dev/cookies Cookie:sessionid=foo
GET / HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Connection: keep-alive
Cookie: sessionid=foo
Host: pie.dev
User-Agent: HTTPie/0.9.9发送多个 cookie（注意：header被引用以防止 shell 解释）：
http pie.dev/cookies 'Cookie:sessionid=foo;another-cookie=bar'
GET / HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Connection: keep-alive
Cookie: sessionid=foo;another-cookie=bar
Host: pie.dev
User-Agent: HTTPie/0.9.9HTTPS
服务器 SSL 证书验证
跳过主机的 SSL 证书验证，可以通过--verify=no（默认为yes）：
http --verify=no https://pie.dev/get
自定义 CA 包
大家还可以使用--verify=<CA_BUNDLE_PATH>设置自定义 CA 包路径：
http --verify=/ssl/custom_ca_bundle https://example.org
客户端 SSL 证书
要将客户端证书用于 SSL 通信，可以使用以下命令传递证书文件的路径--cert：
http --cert=client.pem https://example.org
如果私钥不包含在证书文件中，大家可以通过以下方式传递密钥文件的路径--cert-key：
http --cert=client.crt --cert-key=client.key https://example.org
SSL 版本
使用该--ssl=选项指定要使用的所需协议版本。这将默认为 SSL v2.3，它将协商服务器和安装的 OpenSSL 支持的最高协议。可用的协议是ssl2.3, ssl3, tls1, tls1.1, tls1.2, tls1.3. （实际可用的协议集可能因 OpenSSL 安装而异。）
#Specify the vulnerable SSL v3 protocol to talk to an outdated server:
http --ssl=ssl3 https://vulnerable.example.org
SSL 密码
可以使用 指定可用的密码--ciphers。它应该是OpenSSL 密码列表格式的字符串。
http --ciphers=ECDHE-RSA-AES128-GCM-SHA256 https://pie.dev/get
Sessions
默认情况下，HTTPie 发出的每个请求都完全独立于同一主机之前的任何请求。
但是，HTTPie 也通过该--session=SESSION_NAME_OR_PATH选项支持持久Sessions。在Sessions中，自定义HTTP Header Content-（以or开头的Header除外If-）、身份验证和cookie（手动指定或由服务器发送）在对同一主机的请求之间持续存在。
#Create a new session:
http --session=./session.json pie.dev/headers API-Token:123
#Inspect / edit the generated session file: cat session.json
#Re-use the existing session — the API-Token header will be set:
http --session=./session.json pie.dev/headers
所有Session数据，包括凭据、提示密码、cookie 数据和自定义header都以纯文本形式存储。这意味着Sessions文件也可以在文本编辑器中手动创建和编辑——它们是常规的 JSON。这也意味着任何有权访问Session文件的人都可以读取它们。
命名Sessions
大家可以为每个主机创建一个或多个命名Sessions。例如，可以通过以下方式创建一个名为user1for的新Sessions pie.dev：
http --session=user1 -a user1:password pie.dev/get X-Foo:Bar
user1从现在开始，可以通过名称 ( )来引用Sessions。当选择再次使用Sessions时，将自动设置所有先前指定的身份验证或 HTTP header：
http --session=user1 pie.dev/get
要创建或重用不同的Sessions，只需指定不同的名称：
http --session=user2 -a user2:password pie.dev/get X-Bar:Foo
命名Sessions的数据存储在配置sessions目录子目录内的 JSON 文件中，通常（在 Windows 上）。~/.config/httpie/sessions//.json%APPDATA%\httpie\sessions<host><name>.json
如果大家在 Unix 机器上执行了上述命令，应该能够使用以下命令列出生成的Sessions文件：
ls -l ~/.config/httpie/sessions/pie.dev
匿名Session
可以直接指定Sessions文件的路径，而不是为其命名。这允许跨多个主机重复使用Session：
#Create a session:
http --session=/tmp/session.json example.org
#Use the session to make a request to another host:
http --session=/tmp/session.json admin.example.org
#You can also refer to a previously created named session:
http --session=~/.config/httpie/sessions/another.example.org/test.json example.org
在创建匿名Sessions时，请记住始终包含至少一个/，即使Sessions文件位于当前目录中（即--session=./session.json，而不是只是--session=session.json），否则 HTTPie 会采用命名Sessions。
只读Sessions
要在创建后使用原始Sessions文件而不从请求/响应交换中更新它，请指定Sessions名称 via --session-read-only=SESSION_NAME_OR_PATH。
#If the session file doesn’t exist, then it is created:
http --session-read-only=./ro-session.json pie.dev/headers Custom-Header:orig-value
#But it is not updated:
http --session-read-only=./ro-session.json pie.dev/headers Custom-Header:new-value
参考资料
[1]
安装教程: https://docs.brew.sh/Installation
[2]安装教程: https://chocolatey.org/install
[3]安装教程: https://snapcraft.io/docs/installing-snapd
往期推荐Android 13 第一个开发者版本来了，网友直呼：Android 12 还没玩透！
CSDN企业数字化之路 ——「低代码」发展研讨会北京站现场实录大放送
使用这个库，让你的服务操作 Redis 速度飞起
将 k8s 制作成 3D 射击游戏，好玩到停不下来点分享点收藏点点赞点在看
