Web.Headers

语法

Web.Headers(url as text, optional options as nullable record) as record

关于

返回从 url 下载的标头作为记录。 可以提供可选记录参数 options 来指定额外的属性。 记录可以包含以下字段：

• Query：以编程方式将查询参数添加到 URL，无需担心转义。
• ApiKeyName：如果目标站点具有 API 密钥的概念，则可以使用此参数来指定必须在 URL 中使用的密钥参数的名称（而不是值）。 凭据中提供了实际的密钥值。
• Headers：将此值指定为记录将为 HTTP 请求提供额外的标头。
• Timeout：将此值指定为持续时间将更改 HTTP 请求的超时值。 默认值为 100 秒。
• ExcludedFromCacheKey：将此值指定为列表会将这些 HTTP 标头键排除在对缓存数据的计算之外。
• IsRetry：如果将此逻辑值指定为 true，在提取数据时则将忽略缓存中的任何现有响应。
• ManualStatusHandling：将此值指定为列表将防止对响应具有以下状态代码之一的 HTTP 请求进行任何内置处理。
• RelativePath：如果将此值指定为文本，那么在发出请求前会将此值追加到基 URL。

HTTP 请求是使用 HEAD 方法发出的。 在自定义数据连接器上下文之外，只有一部分响应头可用（出于安全原因）。

示例 1

使用 RelativePath 和 Query 选项检索 "https://bing.com/search?q=Power+Query" 的 HTTP 标头。

使用情况

let    searchText = "Power Query"in    Web.Headers(        "https://www.bing.com",        [            RelativePath = "search",            Query = [q = searchText]        ]    )

输出

([    #"Cache-Control" = "private, max-age=0",    #"Content-Encoding" = "gzip",    #"Content-Length" = "0",    #"Content-Type" = "text/html; charset=utf-8",    Date = "Tue, 14 Dec 2021 16:57:25 GMT",    Expires = "Tue, 14 Dec 2021 16:56:25 GMT",    Vary = "Accept-Encoding"]meta [    Response.Status = 200])