2019-08-31 00:53:08 +08:00
[#]: collector: (lujun9972)
2019-09-05 08:58:42 +08:00
[#]: translator: (geekpi)
2019-08-31 00:53:08 +08:00
[#]: reviewer: ( )
[#]: publisher: ( )
[#]: url: ( )
[#]: subject: (Getting started with HTTPie for API testing)
[#]: via: (https://opensource.com/article/19/8/getting-started-httpie)
[#]: author: (Moshe Zadka https://opensource.com/users/moshezhttps://opensource.com/users/mkalindepauleduhttps://opensource.com/users/jamesf)
2019-09-09 08:54:35 +08:00
使用 HTTPie 进行 API 测试
2019-08-31 00:53:08 +08:00
======
2019-09-09 08:54:35 +08:00
使用 HTTPie 调试 API，
2019-08-31 00:53:08 +08:00
![Raspberry pie with slice missing][1]
2019-09-09 08:54:35 +08:00
[HTTPie][2] 是一个非常易于使用且易于升级的 HTTP 客户端。它的发音为 “aitch-tee-tee-pie” 并以 **http** 运行，它是一个用 Python 编写的命令行工具来用于访问 Web。
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
由于这篇是关于 HTTP 客户端的，因此你需要一个 HTTP 服务器来试用它。在这里，访问 [httpbin.org] [3]，它是一个简单的开源 HTTP 请求和响应服务。httpbin.org 网站是一种测试 Web API 的强大方式，并能仔细管理并显示请求和相应内容，但现在我们将专注于 HTTPie 的强大功能。
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
### Wget 和 cURL 的替代品
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
你可能听说过古老的 [Wget][4] 或稍微更新的 [cURL][5] 工具，它们允许你从命令行访问 Web。它们是为访问网站而编写的， _Web API_ 。
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
网站请求设计介于计算机和正在阅读并响应他们所看到的内容的最终用户之间。这并不太依赖于结构化的响应。但是， ，
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
### 安装 HTTPie
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
有几种方法可以安装 HTTPie。你可以通过包管理器安装， **brew** 、**apt**、**yum** 还是 **dnf** 。但是，如果你已配置 [virtualenvwrapper] [6]，那么你可以用自己的方式安装：
2019-08-31 00:53:08 +08:00
```
$ mkvirtualenv httpie
...
(httpie) $ pip install httpie
...
(httpie) $ deactivate
$ alias http=~/.virtualenvs/httpie/bin/http
$ http -b GET < https: / / httpbin . org / get >
{
< https: / / httpbin . org / get > "
}
```
2019-09-09 08:54:35 +08:00
通过直接将 **http** 设置为虚拟环境中的命令别名，即使虚拟环境在非活动状态，你也可以运行它。 你可以将 **alias** 命令放在 ** .bash_profile** 或 ** .bashrc** 中，这样你就可以使用以下命令升级 HTTPie：
2019-08-31 00:53:08 +08:00
```
`$ ~/.virtualenvs/httpie/bin/pip install -U pip`
```
2019-09-09 08:54:35 +08:00
### 使用 HTTPie 查询网站
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
HTTPie 可以简化查询和测试 API。 这里使用了一个选项， ** -b**（也可以是 ** \--body**）。 没有它，
2019-08-31 00:53:08 +08:00
```
$ http GET < https: / / httpbin . org / get >
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Connection: keep-alive
Content-Encoding: gzip
Content-Length: 177
Content-Type: application/json
Date: Fri, 09 Aug 2019 20:19:47 GMT
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
{
< https: / / httpbin . org / get > "
}
```
2019-09-09 08:54:35 +08:00
这在调试 API 服务时非常重要，因为大量信息在 HTTP 头中发送。 例如，查看发送的 cookie 通常很重要。Httpbin.org 提供了通过 URL 路径设置 cookie（ ） **opensource** ， **awesome** 的 cookie：
2019-08-31 00:53:08 +08:00
```
$ http GET < https: / / httpbin . org / cookies / set / opensource / awesome >
HTTP/1.1 302 FOUND
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Connection: keep-alive
Content-Length: 223
Content-Type: text/html; charset=utf-8
Date: Fri, 09 Aug 2019 20:22:39 GMT
Location: /cookies
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
Set-Cookie: opensource=awesome; Path=/
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
2019-09-09 08:54:35 +08:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
< title > Redirecting...< / title >
< h1 > Redirecting...< / h1 >
< p > You should be redirected automatically to target URL:
< a href = "/cookies" > /cookies< / a > . If not click the link.
2019-08-31 00:53:08 +08:00
```
2019-09-09 08:54:35 +08:00
注意 **Set-Cookie: opensource=awesome; Path=/** 的 HTTP 头。 这表明你预期设置的 cookie 已正确设置，路径为 ** /**。 另请注意，即使你有 **302**重定向，**http** 也不会遵循它。 如果你想要遵循重定向，则需要使用 ** \--follow** 标志请求：
2019-08-31 00:53:08 +08:00
```
$ http --follow GET < https: / / httpbin . org / cookies / set / opensource / awesome >
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Connection: keep-alive
Content-Encoding: gzip
Content-Length: 66
Content-Type: application/json
Date: Sat, 10 Aug 2019 01:33:34 GMT
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
{
}
```
2019-09-09 08:54:35 +08:00
但此时你无法看到原来的 **Set-Cookie** 头。为了看到中间响应，你需要使用 ** \--all**：
2019-08-31 00:53:08 +08:00
```
$ http --headers --all --follow \
GET < https: / / httpbin . org / cookies / set / opensource / awesome >
HTTP/1.1 302 FOUND
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Content-Type: text/html; charset=utf-8
Date: Sat, 10 Aug 2019 01:38:40 GMT
Location: /cookies
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
Set-Cookie: opensource=awesome; Path=/
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
Content-Length: 223
Connection: keep-alive
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Content-Encoding: gzip
Content-Type: application/json
Date: Sat, 10 Aug 2019 01:38:41 GMT
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
Content-Length: 66
Connection: keep-alive
```
2019-09-09 08:54:35 +08:00
打印 body 并不有趣，因为你大多数关心 cookie。如果你像看到中间请求的头， ， ：
2019-08-31 00:53:08 +08:00
```
$ http --print hb --history-print h --all --follow \
GET < https: / / httpbin . org / cookies / set / opensource / awesome >
HTTP/1.1 302 FOUND
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Content-Type: text/html; charset=utf-8
Date: Sat, 10 Aug 2019 01:40:56 GMT
Location: /cookies
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
Set-Cookie: opensource=awesome; Path=/
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
Content-Length: 223
Connection: keep-alive
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Content-Encoding: gzip
Content-Type: application/json
Date: Sat, 10 Aug 2019 01:40:56 GMT
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
Content-Length: 66
Connection: keep-alive
{
}
```
2019-09-09 08:54:35 +08:00
你可以使用 ** \--print** 精确控制打印，并使用 ** \--history-print** 覆盖中间请求的打印。
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
### 使用 HTTPie 下载二进制文件
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
有时 body 并不是文本形式，它需要发送到可被不同应用打开的文件：
2019-08-31 00:53:08 +08:00
```
$ http GET < https: / / httpbin . org / image / jpeg >
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Connection: keep-alive
Content-Length: 35588
Content-Type: image/jpeg
Date: Fri, 09 Aug 2019 20:25:49 GMT
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
+-----------------------------------------+
| NOTE: binary data not shown in terminal |
+-----------------------------------------+
```
2019-09-09 08:54:35 +08:00
要得到正确的图片，你需要保存到文件：
2019-08-31 00:53:08 +08:00
```
$ http --download GET < https: / / httpbin . org / image / jpeg >
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Origin: *
Connection: keep-alive
Content-Length: 35588
Content-Type: image/jpeg
Date: Fri, 09 Aug 2019 20:28:13 GMT
Referrer-Policy: no-referrer-when-downgrade
Server: nginx
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
Downloading 34.75 kB to "jpeg.jpe"
Done. 34.75 kB in 0.00068s (50.05 MB/s)
```
2019-09-09 08:54:35 +08:00
试一下！图片很可爱。
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
### 使用 HTTPie 发送自定义请求
2019-08-31 00:53:08 +08:00
2019-09-09 08:54:35 +08:00
你可以发送指定头。这对于需要非标准头的自定义 Web API 很有用：
2019-08-31 00:53:08 +08:00
```
$ http GET < https: / / httpbin . org / headers > X-Open-Source-Com:Awesome
{
}
```
2019-09-09 08:54:35 +08:00
最后，如果要发送 JSON 字段（尽管可以指定确切的内容），对于许多嵌套较少的输入，你可以使用快捷方式：
2019-08-31 00:53:08 +08:00
```
$ http --body PUT < https: / / httpbin . org / anything > open-source=awesome author=moshez
{
*/* ",
< https: / / httpbin . org / anything > "
}
```
2019-09-09 08:54:35 +08:00
下次在调试 Web API 时，无论时你自己还是别人，记得放下 cURL，
2019-08-31 00:53:08 +08:00
--------------------------------------------------------------------------------
via: https://opensource.com/article/19/8/getting-started-httpie
作者：[Moshe Zadka][a]
选题：[lujun9972][b]
2019-09-09 08:54:35 +08:00
译者：[geekpi](https://github.com/geekpi)
2019-08-31 00:53:08 +08:00
校对：[校对者ID](https://github.com/校对者ID)
本文由 [LCTT ](https://github.com/LCTT/TranslateProject ) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
[a]: https://opensource.com/users/moshezhttps://opensource.com/users/mkalindepauleduhttps://opensource.com/users/jamesf
[b]: https://github.com/lujun9972
[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/pie-raspberry-bake-make-food.png?itok=QRV_R8Fa (Raspberry pie with slice missing)
[2]: https://httpie.org/
[3]: https://github.com/postmanlabs/httpbin
[4]: https://en.wikipedia.org/wiki/Wget
[5]: https://en.wikipedia.org/wiki/CURL
[6]: https://opensource.com/article/19/6/virtual-environments-python-macos
