使用HTTPie进行API测试

使用 HTTPie 调试 API,这是一个用 Python 写的易用的命令行工具。

成都创新互联公司是少有的成都做网站、成都网站建设、成都外贸网站建设、营销型企业网站、微信小程序定制开发、手机APP,开发、制作、设计、友情链接、推广优化一站式服务网络公司,于2013年成立,坚持透明化,价格低,无套路经营理念。让网页惊喜每一位访客多年来深受用户好评

HTTPie 是一个非常易用、易于升级的 HTTP 客户端。它的发音为 “aitch-tee-tee-pie” 并以 http 命令运行,它是一个用 Python 编写的来用于访问 Web 的命令行工具。

由于这是一篇关于 HTTP 客户端的指导文章,因此你需要一个 HTTP 服务器来试用它。在这里,访问 httpbin.org,它是一个简单的开源 HTTP 请求和响应服务。httpbin.org 网站是一种测试 Web API 的强大方式,并能仔细管理并显示请求和响应内容,不过现在让我们专注于 HTTPie 的强大功能。

Wget 和 cURL 的替代品

你可能听说过古老的 Wget 或稍微新一些的 cURL 工具,它们允许你从命令行访问 Web。它们是为访问网站而编写的,而 HTTPie 则用于访问 Web API。

网站请求发生在计算机和正在阅读并响应它所看到的内容的最终用户之间,这并不太依赖于结构化的响应。但是,API 请求会在两台计算机之间进行结构化调用,人并不是该流程内的一部分,像 HTTPie 这样的命令行工具的参数可以有效地处理这个问题。

安装 HTTPie

有几种方法可以安装 HTTPie。你可以通过包管理器安装,无论你使用的是 brewaptyum 还是 dnf。但是,如果你已配置 virtualenvwrapper,那么你可以用自己的方式安装:

 
 
 
  1. $ mkvirtualenv httpie
  2. ...
  3. (httpie) $ pip install httpie
  4. ...
  5. (httpie) $ deactivate
  6. $ alias http=~/.virtualenvs/httpie/bin/http
  7. $ http -b GET https://httpbin.org/get
  8. {
  9. "args": {},
  10. "headers": {
  11. "Accept": "*/*",
  12. "Accept-Encoding": "gzip, deflate",
  13. "Host": "httpbin.org",
  14. "User-Agent": "HTTPie/1.0.2"
  15. },
  16. "origin": "104.220.242.210, 104.220.242.210",
  17. "url": "https://httpbin.org/get"
  18. }

通过将 http 别名指向为虚拟环境中的命令,即使虚拟环境在非活动状态,你也可以运行它。你可以将 alias 命令放在 .bash_profile.bashrc 中,这样你就可以使用以下命令升级 HTTPie:

 
 
 
  1. $ ~/.virtualenvs/httpie/bin/pip install -U pip

使用 HTTPie 查询网站

HTTPie 可以简化查询和测试 API。上面使用了一个选项,-b(即 --body)。没有它,HTTPie 将默认打印整个响应,包括响应头:

 
 
 
  1. $ http GET https://httpbin.org/get
  2. HTTP/1.1 200 OK
  3. Access-Control-Allow-Credentials: true
  4. Access-Control-Allow-Origin: *
  5. Connection: keep-alive
  6. Content-Encoding: gzip
  7. Content-Length: 177
  8. Content-Type: application/json
  9. Date: Fri, 09 Aug 2019 20:19:47 GMT
  10. Referrer-Policy: no-referrer-when-downgrade
  11. Server: nginx
  12. X-Content-Type-Options: nosniff
  13. X-Frame-Options: DENY
  14. X-XSS-Protection: 1; mode=block
  15. {
  16. "args": {},
  17. "headers": {
  18. "Accept": "*/*",
  19. "Accept-Encoding": "gzip, deflate",
  20. "Host": "httpbin.org",
  21. "User-Agent": "HTTPie/1.0.2"
  22. },
  23. "origin": "104.220.242.210, 104.220.242.210",
  24. "url": "https://httpbin.org/get"
  25. }

这在调试 API 服务时非常重要,因为大量信息在响应头中发送。例如,查看发送的 cookie 通常很重要。httpbin.org 提供了通过 URL 路径设置 cookie(用于测试目的)的方式。以下设置一个标题为 opensource, 值为 awesome 的 cookie:

 
 
 
  1. $ http GET https://httpbin.org/cookies/set/opensource/awesome
  2. HTTP/1.1 302 FOUND
  3. Access-Control-Allow-Credentials: true
  4. Access-Control-Allow-Origin: *
  5. Connection: keep-alive
  6. Content-Length: 223
  7. Content-Type: text/html; charset=utf-8
  8. Date: Fri, 09 Aug 2019 20:22:39 GMT
  9. Location: /cookies
  10. Referrer-Policy: no-referrer-when-downgrade
  11. Server: nginx
  12. Set-Cookie: opensource=awesome; Path=/
  13. X-Content-Type-Options: nosniff
  14. X-Frame-Options: DENY
  15. X-XSS-Protection: 1; mode=block
  16. Redirecting...
  17. Redirecting...

  18. You should be redirected automatically to target URL:

  19. /cookies. If not click the link.

注意 Set-Cookie: opensource=awesome; Path=/ 的响应头。这表明你预期设置的 cookie 已正确设置,路径为 /。另请注意,即使你得到了 302 重定向,http 也不会遵循它。如果你想要遵循重定向,则需要明确使用 --follow 标志请求:

 
 
 
  1. $ http --follow GET https://httpbin.org/cookies/set/opensource/awesome
  2. HTTP/1.1 200 OK
  3. Access-Control-Allow-Credentials: true
  4. Access-Control-Allow-Origin: *
  5. Connection: keep-alive
  6. Content-Encoding: gzip
  7. Content-Length: 66
  8. Content-Type: application/json
  9. Date: Sat, 10 Aug 2019 01:33:34 GMT
  10. Referrer-Policy: no-referrer-when-downgrade
  11. Server: nginx
  12. X-Content-Type-Options: nosniff
  13. X-Frame-Options: DENY
  14. X-XSS-Protection: 1; mode=block
  15. {
  16. "cookies": {
  17. "opensource": "awesome"
  18. }
  19. }

但此时你无法看到原来的 Set-Cookie 头。为了看到中间响应,你需要使用 --all

 
 
 
  1. $ http --headers --all --follow GET https://httpbin.org/cookies/set/opensource/awesome
  2. HTTP/1.1 302 FOUND
  3. Access-Control-Allow-Credentials: true
  4. Access-Control-Allow-Origin: *
  5. Content-Type: text/html; charset=utf-8
  6. Date: Sat, 10 Aug 2019 01:38:40 GMT
  7. Location: /cookies
  8. Referrer-Policy: no-referrer-when-downgrade
  9. Server: nginx
  10. Set-Cookie: opensource=awesome; Path=/
  11. X-Content-Type-Options: nosniff
  12. X-Frame-Options: DENY
  13. X-XSS-Protection: 1; mode=block
  14. Content-Length: 223
  15. Connection: keep-alive
  16. HTTP/1.1 200 OK
  17. Access-Control-Allow-Credentials: true
  18. Access-Control-Allow-Origin: *
  19. Content-Encoding: gzip
  20. Content-Type: application/json
  21. Date: Sat, 10 Aug 2019 01:38:41 GMT
  22. Referrer-Policy: no-referrer-when-downgrade
  23. Server: nginx
  24. X-Content-Type-Options: nosniff
  25. X-Frame-Options: DENY
  26. X-XSS-Protection: 1; mode=block
  27. Content-Length: 66
  28. Connection: keep-alive

打印响应体并不有趣,因为你大多数时候只关心 cookie。如果你想看到中间请求的响应头,而不是最终请求中的响应体,你可以使用:

 
 
 
  1. $ http --print hb --history-print h --all --follow GET https://httpbin.org/cookies/set/opensource/awesome
  2. HTTP/1.1 302 FOUND
  3. Access-Control-Allow-Credentials: true
  4. Access-Control-Allow-Origin: *
  5. Content-Type: text/html; charset=utf-8
  6. Date: Sat, 10 Aug 2019 01:40:56 GMT
  7. Location: /cookies
  8. Referrer-Policy: no-referrer-when-downgrade
  9. Server: nginx
  10. Set-Cookie: opensource=awesome; Path=/
  11. X-Content-Type-Options: nosniff
  12. X-Frame-Options: DENY
  13. X-XSS-Protection: 1; mode=block
  14. Content-Length: 223
  15. Connection: keep-alive
  16. HTTP/1.1 200 OK
  17. Access-Control-Allow-Credentials: true
  18. Access-Control-Allow-Origin: *
  19. Content-Encoding: gzip
  20. Content-Type: application/json
  21. Date: Sat, 10 Aug 2019 01:40:56 GMT
  22. Referrer-Policy: no-referrer-when-downgrade
  23. Server: nginx
  24. X-Content-Type-Options: nosniff
  25. X-Frame-Options: DENY
  26. X-XSS-Protection: 1; mode=block
  27. Content-Length: 66
  28. Connection: keep-alive
  29. {
  30. "cookies": {
  31. "opensource": "awesome"
  32. }
  33. }

你可以使用 --print 精确控制打印的内容(h:响应头;b:响应体),并使用 --history-print 覆盖中间请求的打印内容设置。

使用 HTTPie 下载二进制文件

有时响应体并不是文本形式,它需要发送到可被不同应用打开的文件:

 
 
 
  1. $ http GET https://httpbin.org/image/jpeg
  2. HTTP/1.1 200 OK
  3. Access-Control-Allow-Credentials: true
  4. Access-Control-Allow-Origin: *
  5. Connection: keep-alive
  6. Content-Length: 35588
  7. Content-Type: image/jpeg
  8. Date: Fri, 09 Aug 2019 20:25:49 GMT
  9. Referrer-Policy: no-referrer-when-downgrade
  10. Server: nginx
  11. X-Content-Type-Options: nosniff
  12. X-Frame-Options: DENY
  13. X-XSS-Protection: 1; mode=block
  14. +-----------------------------------------+
  15. | NOTE: binary data not shown in terminal |
  16. +-----------------------------------------+

要得到正确的图片,你需要保存到文件:

 
 
 
  1. $ http --download GET https://httpbin.org/image/jpeg
  2. HTTP/1.1 200 OK
  3. Access-Control-Allow-Credentials: true
  4. Access-Control-Allow-Origin: *
  5. Connection: keep-alive
  6. Content-Length: 35588
  7. Content-Type: image/jpeg
  8. Date: Fri, 09 Aug 2019 20:28:13 GMT
  9. Referrer-Policy: no-referrer-when-downgrade
  10. Server: nginx
  11. X-Content-Type-Options: nosniff
  12. X-Frame-Options: DENY
  13. X-XSS-Protection: 1; mode=block
  14. Downloading 34.75 kB to "jpeg.jpe"
  15. Done. 34.75 kB in 0.00068s (50.05 MB/s)

试一下!图片很可爱。

使用 HTTPie 发送自定义请求

你可以发送指定的请求头。这对于需要非标准头的自定义 Web API 很有用:

 
 
 
  1. $ http GET https://httpbin.org/headers X-Open-Source-Com:Awesome
  2. {
  3. "headers": {
  4. "Accept": "*/*",
  5. "Accept-Encoding": "gzip, deflate",
  6. "Host": "httpbin.org",
  7. "User-Agent": "HTTPie/1.0.2",
  8. "X-Open-Source-Com": "Awesome"
  9. }
  10. }

最后,如果要发送 JSON 字段(尽管可以指定确切的内容),对于许多嵌套较少的输入,你可以使用快捷方式:

 
 
 
  1. $ http --body PUT https://httpbin.org/anything open-source=awesome author=moshez
  2. {
  3. "args": {},
  4. "data": "{\"open-source\": \"awesome\", \"author\": \"moshez\"}",
  5. "files": {},
  6. "form": {},
  7. "headers": {
  8. "Accept": "application/json, */*",
  9. "Accept-Encoding": "gzip, deflate",
  10. "Content-Length": "46",
  11. "Content-Type": "application/json",
  12. "Host": "httpbin.org",
  13. "User-Agent": "HTTPie/1.0.2"
  14. },
  15. "json": {
  16. "author": "moshez",
  17. "open-source": "awesome"
  18. },
  19. "method": "PUT",
  20. "origin": "73.162.254.113, 73.162.254.113",
  21. "url": "https://httpbin.org/anything"
  22. }

下次在调试 Web API 时,无论是你自己的还是别人的,记得放下 cURL,试试 HTTPie 这个命令行工具。

网页题目:使用HTTPie进行API测试
本文网址:http://www.shufengxianlan.com/qtweb/news28/135778.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联