閱讀英文

共用方式為


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
])