探索 HTTP 请求语法

在 HTTP 请求中使用注释

• 在请求中，以 // 或 # 开头的任何行都将视为注释行。

  // A basic request GET http://example.com/a/

为 HTTP 请求设置名称

为了方便在 运行/调试配置、 Search Everywhere 和 Run Anything 中快速查找请求，您可以为其命名。

• 在请求上方并靠近 ###、 # @name 或 # @name = 的位置键入名称。

  

如果请求未指定名称，GoLand 将使用其在请求文件中的位置（例如 #1 ）作为请求名称。 如果请求文件中包含多个名称相同的请求，GoLand 将在每个请求名称后附加请求的位置编号。 这样可确保每个请求名称唯一，方便从 服务 工具窗口、运行/调试配置等位置快速找到所需请求。

为 GET 请求使用简写形式

• 对于 GET 请求，您可以省略请求方法，仅指定 URI。

  // A basic request https://example.com/a/

在单个文件中组合多个请求

1. 在请求下方输入 ### 分隔符，表示请求结束。

   // A basic request https://example.com/a/ ###

2. 在分隔符下方编写另一个请求。

   // A basic request https://example.com/a/ ### // A second request using the GET method https://example.com:8080/api/html/get?id=123&value=content

将较长的请求拆分为多行

• 除第一行外，所有查询字符串行都应缩进。

  // Using line breaks with indent GET http://example.com:8080 /api /html /get ?id=123 &value=content

• 如果查询字符串使 URL 过长，您可以使用专用上下文操作将每个查询参数放在新的一行。 将光标放在查询字符串部分，按 Alt+Enter （显示上下文操作 ），然后选择 将查询形参放在单独的行中。

  GET https://example.com:8080/api/get/html?firstname=John&lastname=Doe&planet=Tatooine&town=Freetown

  GET https://example.com:8080/api/get/html? firstname=John& lastname=Doe& planet=Tatooine& town=Freetown

• 类似地，您也可以对请求中的 body 进行格式化，使用 Content-Type：application/x-www-form-urlencoded。 将光标放在 body 处，按 Alt+Enter （显示上下文操作 ），然后选择 将form-urlencoded 形参放在单独的行中。

  POST https://ijhttp-examples.jetbrains.com/post Content-Type: application/x-www-form-urlencoded key1=value1&key2=value2&key3=value3&key4=value4&key5=value5

  POST https://ijhttp-examples.jetbrains.com/post Content-Type: application/x-www-form-urlencoded key1 = value1 & key2 = value2 & key3 = value3 & key4 = value4 & key5 = value5

  要配置 x-www-form-urlencoded body 的换行方式，请使用 设置 | 编辑器 | 代码样式 | HTTP 请求 | 换行和大括号 | Form-urlencoded 形参换行。 要配置 = 前后的空格以及 & 前的空格，请使用 设置 | 编辑器 | 代码样式 | HTTP 请求 | 空格。

通过身份验证访问 Web 服务

• 根据所访问的 Web 服务，提供 basic 或 digest Authorization 头。

  // Basic authentication GET http://example.com Authorization: Basic username password ### // Digest authentication GET http://example.com Authorization: Digest username password

提供请求消息体

在请求中，将请求体之前添加一个空行，然后执行以下任一操作：

• 直接在当前位置输入请求体：

  // The request body is provided in place POST https://example.com:8080/api/html/post HTTP/1.1 Content-Type: application/json Cookie: key=first-value { "key" : "value", "list": [1, 2, 3] }

  如果您将 Content-Type 头字段设置为 GoLand 支持的某个 语言 ，则对应的语言片段将被 自动注入 到 HTTP 请求消息体中。 如果没有指定 Content-Type ，则可以手动注入语言片段。

• 要从文件中读取请求体，请输入 < 符号并跟上文件路径。

  // The request body is read from a file POST https://example.com:8080/api/html/post Content-Type: application/json < ./input.json

使用 multipart/form-data 内容类型

• 将请求的 Content-Type 设置为 multipart/form-data。 要将文件作为 multipart/form-data 消息的一部分发送，请在 Content-Disposition 头中包含 文件名 参数。

  POST https://example.com/api/upload HTTP/1.1 Content-Type: multipart/form-data; boundary=boundary --boundary Content-Disposition: form-data; name="first"; filename="input.txt" // The 'input.txt' file will be uploaded < ./input.txt --boundary Content-Disposition: form-data; name="second"; filename="input-second.txt" // A temporary 'input-second.txt' file with the 'Text' content will be created and uploaded Text --boundary Content-Disposition: form-data; name="third"; // The 'input.txt' file contents will be sent as plain text. < ./input.txt --boundary--

禁用跟随重定向

当 HTTP 请求发生重定向（收到 3xx 状态码）时，将返回重定向页面的响应。 在 服务 工具窗口中，您可以查看重定向页面响应以及请求过程中发生的所有重定向。

您可能希望禁止跟随重定向。 在这种情况下，将返回实际的重定向响应头（例如 301 或 302）。

• 在请求之前，添加包含 @no-redirect 标签的注释行。

  // @no-redirect example.com/status/301

如果已有重定向请求，您可以在 服务 工具窗口的 重定向 列表旁点击 禁用。 这会将 @no-redirect 标签添加到初始请求中。

禁止将请求保存在请求历史中

如有必要，您可以禁止将请求保存到 请求历史 中。 如果请求中包含某些敏感数据，且您不希望记录日志，此功能将非常有用。

• 在请求前添加一行包含 @no-log 标签的注释。

  // @no-log GET example.com/api

禁止将接收到的 Cookie 保存到 Cookie Jar 中

如有需要，您可以防止将接收到的 cookie 保存到 cookies jar 中。 这样，您就可以避免手动删除 http-client.cookies 文件中的不需要的 cookie。

• 在请求前添加一行包含 @no-cookie-jar 标签的注释。

  // @no-cookie-jar GET example.com/api

禁用编码

默认情况下，HTTP Client 会将请求参数和请求体编码为 ASCII 格式。 例如，请求参数中的斜杠字符将被编码为 %2F。 您可以禁用编码，以按原样发送请求。

• 在请求前添加一行包含 @no-auto-encoding 标签的注释。

  使用该标签后，请求参数和请求体将不会被编码：

  # @no-auto-encoding GET https://examples.com/api? name=@#$somebody& qwerty=%40%23%24

  最终请求将按原样发送：

  https://examples.com/api?name=@#$somebody&qwerty=%40%23%24

  默认情况下，在未使用该标签时将启用编码。

  ### Default behavior GET https://examples.com/api? name=@#$somebody& qwerty=%40%23%24

  在此请求中，参数将被编码：

  https://examples.com/api?name=%40%23%24somebody&qwerty=%40%23%24

自定义 HTTP 请求超时

HTTP Client 建立与服务器连接的超时时间为 60 秒，正在进行的连接中等待新数据包的超时时间另为 60 秒。 您可以自定义这两个超时时间。

• 要为已建立的连接设置新数据包的超时时间，请在请求前添加一行包含 @timeout 标签的注释。

  # @timeout 600 GET example.com/api

• 要设置连接超时时间，请在请求前添加一行包含 @connection-timeout 标签的注释。

  // @connection-timeout 2 m GET example.com/api

默认情况下，超时值的单位为秒，您也可以在值后添加明确的时间单位： ms 表示毫秒， s 表示秒， m 表示分钟，例如 100 ms 或 5 m。