Web.Contents
语法
Web.Contents(url as text, optional options as nullable record) as binary
关于
以二进制形式返回从 url 下载的内容。 可以提供可选记录参数 options 来指定额外的属性。 记录可以包含以下字段：
Query：以编程方式将查询参数添加到 URL，无需担心转义。ApiKeyName：如果目标站点具有 API 密钥的概念，则可以使用此参数来指定必须在 URL 中使用的密钥参数的名称（而不是值）。 凭据中提供了实际的密钥值。Headers：将此值指定为记录将为 HTTP 请求提供额外的标头。Timeout：将此值指定为持续时间将更改 HTTP 请求的超时值。 默认值为 100 秒。ExcludedFromCacheKey：将此值指定为列表会将这些 HTTP 标头键排除在对缓存数据的计算之外。IsRetry：如果将此逻辑值指定为 true，在提取数据时则将忽略缓存中的任何现有响应。ManualStatusHandling：将此值指定为列表将防止对响应具有以下状态代码之一的 HTTP 请求进行任何内置处理。RelativePath：如果将此值指定为文本，那么在发出请求前会将此值追加到基 URL。Content：指定此值会将 Web 请求从 GET 更改为 POST，并使用此选项的值作为 POST 的内容。
HTTP 请求以 GET（未指定内容时）或 POST（指定内容时）的形式发出。 POST 请求只能匿名发出。
HTTP 响应的标头可在二进制结果中用作元数据。 在自定义数据连接器上下文之外，只有一部分响应头可用（出于安全原因）。
示例 1
使用 RelativePath 和 Query 选项检索 "https://bing.com/search?q=Power+Query" 的内容。 这些选项可用于动态查询静态基 URL。
使用情况
let
searchText = "Power Query"
in
Web.Contents(
"https://www.bing.com",
[
RelativePath = "search",
Query = [q = searchText]
]
)
输出
binary
示例 2
对 URL 执行 POST，传递二进制 JSON 有效负载，将响应解析为 JSON。
使用情况
let
url = ...,
headers = [#"Content-Type" = "application/json"],
postData = Json.FromValue([x = 235.7, y = 41.53]),
response = Web.Contents(
url,
[
Headers = headers,
Content = postData
]
),
jsonResponse = Json.Document(response)
in
jsonResponse
输出
table
示例 3
连接一个安全 URL，该 URL 接受身份验证密钥作为查询字符串的一部分。 可通过在 M 中指定密钥的名称（而不是其值），选择 Web API 身份验证，并输入密钥值作为 Web API 凭据的一部分，来安全地提供密钥，而不是在 M 中对密钥进行硬编码（这会带来安全风险）。 这样使用时，以下示例将生成对 "https://contoso.com/api/customers/get?api_key=******" 的请求。
使用情况
Web.Contents("https://contoso.com/api/customers/get", [ApiKeyName="api_key"])
输出
binary