Číst v angličtině

Sdílet prostřednictvím


Web.Headers

Syntaxe

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

O uživateli

Vrátí hlavičky stažené ze url záznamu. Volitelný parametr záznamu options, lze zadat další vlastnosti. Záznam může obsahovat následující pole:

  • Query: Do adresy URL můžete přidávat parametry dotazu prostřednictvím kódu programu, aniž byste se museli starat o únik.
  • ApiKeyName: Pokud má cílový web představu o klíči rozhraní API, lze tento parametr použít k určení názvu (nikoli hodnoty) parametru klíče, který se musí použít v adrese URL. Skutečná hodnota klíče je k dispozici v přihlašovacích údajích.
  • Headers: Zadáním této hodnoty jako záznamu se do požadavku HTTP zadají další hlavičky.
  • Timeout: Zadáním této hodnoty jako doby trvání se změní časový limit požadavku HTTP. Výchozí hodnota je 100 sekund.
  • ExcludedFromCacheKey: Zadáním této hodnoty jako seznamu se tyto klíče hlaviček HTTP vyloučí z výpočtu pro ukládání dat do mezipaměti.
  • IsRetry: Zadání této logické hodnoty jako true bude při načítání dat ignorovat všechny existující odpovědi v mezipaměti.
  • ManualStatusHandling: Zadáním této hodnoty jako seznamu zabráníte jakémukoli integrovanému zpracování požadavků HTTP, jejichž odpověď má jeden z těchto stavových kódů.
  • RelativePath: Tuto hodnotu zadáte jako text, který před provedením požadavku připojí k základní adrese URL.

Požadavek HTTP se provádí pomocí metody HEAD. Mimo kontext vlastního datového konektoru je k dispozici pouze podmnožina hlaviček odpovědí (z bezpečnostních důvodů).

Příklad 1

Načtěte hlavičky HTTP pro "https://bing.com/search?q=Power+Query" použití možností RelativePath a Query.

Využití

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

Výstup

([
    #"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
])