Web.Headers

Syntax

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

O

Vráti hlavičky stiahnuté z url ako záznam. Ak chcete určiť ďalšie vlastnosti, možno zadať voliteľný parameter záznamu options. Záznam môže obsahovať nasledujúce polia:

• Query: Programovaním pridajte parametre dotazu do URL adresy bez toho, aby ste sa museli obávať o zadávanie úniku údajov.
• ApiKeyName: Ak má cieľová lokalita koncept kľúča rozhrania API, tento parameter možno použiť na určenie názvu kľúča (nie hodnoty) parametra kľúča, ktorý sa musí použiť v URL adrese. Skutočná hodnota kľúča je zadaná v prihlasovacom údajoch.
• Headers: Určením tejto hodnoty ako záznamu sa do požiadavky HTTP dodajú ďalšie hlavičky.
• Timeout: Ak určíte túto hodnotu ako trvanie, zmení sa časový limit požiadavky HTTP. Predvolená hodnota je 100 sekúnd.
• ExcludedFromCacheKey: Ak zadáte túto hodnotu ako zoznam, vylúčia sa tieto kľúče hlavičiek HTTP a nebudú viac súčasťou výpočtu pre ukladanie údajov do vyrovnávacej pamäte.
• IsRetry: Ak zadáte túto logickú hodnotu ako true, budú sa pri načítaní údajov ignorovať všetky existujúce odpovede vo vyrovnávacej pamäti.
• ManualStatusHandling: Ak zadáte túto hodnotu ako zoznam, zabráni sa akémukoľvek vstavanému spracovávaniu pre požiadavky HTTP, ktorých odpoveď má jeden z týchto kódov stavu.
• RelativePath: Ak zadáte túto hodnotu ako text, tento text sa pripojí k základnej URL adrese pred vytvorením požiadavky.

Požiadavka HTTP sa vykoná pomocou metódy HEAD. Mimo kontextu vlastného konektora údajov je k dispozícii iba podmnožina hlavičiek odpovede (z bezpečnostných dôvodov).

Príklad č. 1

Načítajte hlavičky HTTP pre "https://bing.com/search?q=Power+Query" pomocou možností RelativePath a Query.

používania

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

výstupu

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