HTTPie官方版

HTTPie简介

HTTPie是命令行类型的HTTP客户端。用户可以通过命令直接测试网页、调试HTTP、测试HTTP项。您可以发送各种网页请求。您可以使用内置的默认请求头快速编辑请求命令。您可以向发送一个或多个cookie，也可以提供身份验证功能。可以在软件中配置网络HTTP认证方案，支持基础认证、抽象授权、密码认证、HTTP重定向等功能，让用户在管理HTTP时得到更多帮助。新版本修复了请求和响应(# 1006)之间缺少空行的问题，并增加了对流式上传的支持！

HTTPie软件功能

HTTPie:API时代的人性化CLI CLI HTTP客户端

HTTPie(发音为aitch-tee-tee-pie)是一个命令行HTTP客户端。目标是使命令行界面和网络服务之间的交互尽可能友好。HTTPie是为测试和调试而设计的，通常与API和HTTP交互。http和https命令允许创建和发送任意的HTTP请求。它们使用简单自然的语法，并提供格式和颜色输出。

表达性和直观的语法

以及格式化和彩色的终端输出。

内置支持

和文件上传。

HTTPS，代理和认证

请求任意数据

自定义标题

连续会议

类似于et的下载

Linux、macOS和Windows支持

外部程序

文献文献

测试范围

HTTPie软件特色

增加了对上传文件的自定义内容类型的支持。

增加了对$ xdg _ config _ home (# 920)的支持。

增加了对设置Cookie触发的Cookie过期的支持。

添加& # 8211；格式-允许禁用排序等选项。

添加& # 8211；排序并& # 8211；未排序设置所有与排序相关的快捷方式& # 8211；格式选项.

添加& # 8211；允许配置OpenSSL密码的密码

增加了netrc对这个插件的支持。对于& # 8211；th-type =基本和启用摘要，第三方可以选择加入。

HTTPie使用说明

7个请求项目

有几种不同类型的请求项，它们提供了一种便捷的机制来指定HTTP头、简单的on和form数据、文件和l参数。

它们是在l之后指定的键/值对。公共所有权的优点是它们成为要发送的实际请求的一部分，并且它们的类型仅由分区使用::，=，:=，=，@ = @，以及:= @那些期望文件路径作为值的文件。

项目类别描述

1.HTTP头名称:值

任何HTTP头，比如X-API-Token:123。

2.URL参数名称= =值

将给定的名称/值对作为查询字符串参数追加到L。使用= =分隔符。

3.数据字段字段=值，字段= @ file.txt。

请求将数据字段序列化为ON对象(默认)并对表单进行编码(使用& # 8211；表单，-f)或序列化为多部分/表单数据(使用& # 8211；多部分的).

4.原ON字段字段:=json，字段:= @ file.json。

有用的发送开和一个或多个字段需要一个布尔，数字嵌套对象，或数组，例如，膳食:= '[& # 8220；火腿& # 8221；,”垃圾邮件& # 8221；]’或件数:= [1，2，3](注意引号)。

5.字段上传字段@/dir/file field @ file；type=mime

仅可用于–form, -f和 –multipart。例如screenshot@~/Pictures/img.png，或’cv@cv.txt;type=text/markdown’。使用–form，文件字段的存在会导致–multipart请求。仅适用于& # 8211；表格，-f和& # 8211；多部分的.比如截图@~/Pictures/img.png，或者& # 8217；cv @ cv . txt；type = text/markdown & # 8217；。使用& # 8211；形式，文件字段的存在会导致& # 8211；多部分请求。

下载文件名

HTTPie以三种互斥的方式确定输出文件名(优先级递减):

您可以明确提供& # 8211；输出，-o .如果文件已经存在(或附加到& # 8211；继续，-c)，将被覆盖。

您可以在可选的内容处置响应头中指定文件名。从提供的文件名中删除所有前导点。

HTTPie最后使用的方法是根据请求L和响应的组合生成文件名Content-Type。l最初总是用作生成文件名的基础——即使有一个或多个重定向。

为防止因覆盖而导致数据丢失，HTTPie将在必要时为文件名添加一个唯一的数字后缀(除非& # 8211；输出，-o ).

下载管道

当响应标题和进度仍显示在终端中时，您也可以将响应正文重定向到另一个程序:

运行$ http-d https://github.com/httpie/httpie/archive/master.tar.gz

继续下载

如果& # 8211；输出，-o，可以用& # 8211；继续，-c选项继续部分下载。这仅适用于支持范围请求和206部分内容响应的应用程序。如果不支持该文件，只需下载整个文件:

运行example.org/file

其他注意事项

& # 8211；下载选项仅更改如何处理响应正文。

您仍然可以设置自定义标题并使用会话& # 8211；啰嗦，-v等。

–下载总是意味着& # 8211；跟随(跟随重定向)。

–下载也意味着& # 8211；检查状态(错误的HTTP状态将导致非零静态代码)。

1如果文本尚未完全下载，HTTPie将退出，并显示状态代码(错误)。

接受-编码不能使用设置& # 8211；下载.

命名会议

您可以为每个主机创建一个或多个命名会话。例如，这是一个方法pie.dev，您可以创建一个名为user1:

运行$ http & # 8211会话=用户1 -a用户1:密码pie.dev/get X-Foo:Bar

从现在开始，您可以通过会话名称(user1)来引用会话。当您选择重用会话时，将自动设置任何以前指定的身份验证或HTTP头:

运行$ http & # 8211会话=用户1 pie.dev/get

要创建或重用其他会话，只需指定另一个名称:

运行$ http & # 8211会话=用户2 -a用户2:密码pie.dev/get X-Bar:Foo

命名会话的数据存储在ON文件中会话的子目录配置目录中，通常为:~/。config/httpie/sessions/。JSON(% app data % httpie sessions 。JSON在Windows上)。

如果在UNIX机器上执行上述命令，您应该能够使用以下命令列出生成的会话文件:

运行$ ls-l/。config/httpie/sessions/pie.dev。

匿名会议

除了名称，还可以直接指定会话文件的路径。这允许会话在多个主机之间重复使用:

运行#创建会话:

$ http & # 8211example.org

运行#使用会话向另一台主机发出请求:

$ http & # 8211admin.example.org

运行#您也可以引用以前创建的命名会话:

$ http & # 8211=〜/会议。example.org

创建匿名会话时，请记住始终至少包含一个/，即使会话文件位于当前目录中(即& # 8211；会话=。/session.json而不仅仅是at & # 8211Session=session.json)，否则HTTPie将假定使用了命名会话。

只读会话

要使用现有会话文件而不创建它并在请求/响应交换中更新它，请& # 8211；session-只读= session _ name _ or _ path通过指定会话名称进行更改。

运行#如果会话文件不存在，将创建它:

$ http & # 8211会话-只读=。/session . JSON pie.dev/headers自定义-标题:og-值

运行#而不更新:

$ http & # 8211会话只读=。/session . JSON pie.dev/headers自定义标头:新值

Cookie的存储行为

TL；灾难恢复:Cookie存储优先级:响应>:命令行请求>:会话文件

要在会话中设置Cookie，可以使用以下三个选项:

Set-Cookie从获取响应头

运行$ http & # 8211会话=。/session . JSON pie.dev/cookie/set?

正如您在cookie中看到的，从命令行设置cookie的名称和值。

运行$ http & # 8211会话=。pie.dev/headers饼干:foo = bar

在会话的json文件中手动设置cookie参数

Cookies将以上面指定的优先级设置在会话文件中。例如，通过命令行设置的cookie将覆盖会话文件中存储的同名cookie。如果返回的Set-cookie带有同名cookie的标头，则返回的Cookie将覆盖预先存在的Cookie。

过期的cookie将永远不会被存储。如果会话文件中的cookie过期，它将在发送新请求之前被删除。如果现有的Cookie无效，它也将从会话文件中删除。

轮廓

HTTPie使用一个简单的config.json文件。默认情况下，该文件不存在，但您可以手动创建它。

配置文件目录

要查看安装的确切位置，请运行http & # 8211和debug config_dir来查看输出。

在大多数平台上，配置文件的默认位置是$ xdg _ config _ home/httpie/config . JSON(默认值是~/)。config/httpie/config.json)。

为了向后兼容，如果目录~/。httpie存在，将使用那里的配置文件。

在Windows上，配置文件位于% appdata% httpie config.json。

您可以通过设置$HTTPIE_CONFIG_DIR环境变量来更改配置目录

可配置选项

目前，HTTPie提供了一个可配置的选项:

爆燃选项

数组(默认为空)应该应用于HTTPie的每个调用的默认选项。

例如，您可以使用此配置选项来更改默认颜色主题:

即使在技术上可以包含HTTPie的任何选项，但不建议以可能使您与更广阔的世界兼容的方式修改默认行为，因为这可能会造成很多混乱。

取消设置以前指定的选项。

是& # 8211；No-OPTION通过命令行传递的参数(例如& # 8211；没有风格或& # 8211；无会话)取消配置文件中的默认选项或以任何其他方式为特定调用指定的默认选项。

接口设计

命令参数的语法非常接近通过网络发送的实际HTTP请求。它的优点是容易记忆和阅读。只有通过内联请求元素，HTTP请求通常才能转换成HTTPie参数列表。例如，比较以下HTTP请求:

请注意，元素的顺序和语法非常相似，只有一小部分命令用于控制HTTPie，它并不直接对应于请求的任何部分(这里只有-f requestHTTPiesend form request)。

两种模式& # 8211；漂亮=全部(终端默认)和& # 8211；漂亮=无(重定向输出默认值)允许用户友好的交互使用和脚本使用，其中HTTPie用作通用HTTP客户端。