Web.Headers

Syntaks

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

Om

Returnerer de headere, der er downloadet fra url som en post. Der kan angives en valgfri postparameter for optionsat angive yderligere egenskaber. Posten kan indeholde følgende felter:

• Query: Føj programmatisk forespørgselsparametre til URL-adressen uden at skulle bekymre dig om at undslippe.
• ApiKeyName: Hvis destinationswebstedet har en definition af en API-nøgle, kan denne parameter bruges til at angive navnet (ikke værdien) på den nøgleparameter, der skal bruges i URL-adressen. Den faktiske nøgleværdi angives i legitimationsoplysningerne.
• Headers: Hvis denne værdi angives som en post, vil der blive føjet flere overskrifter til en HTTP-anmodning.
• Timeout: Hvis denne værdi angives som en varighed, ændres timeout for en HTTP-anmodning. Standardværdien er 100 sekunder.
• ExcludedFromCacheKey: Hvis denne værdi angives som en liste, udelukkes disse HTTP-headernøgler fra at være en del af beregningen af cachelagring af data.
• IsRetry: Hvis denne logiske værdi angives som true, ignoreres alle eksisterende svar i cachen, når der hentes data.
• ManualStatusHandling: Hvis denne værdi angives som en liste, forhindres enhver indbygget håndtering af HTTP-anmodninger, hvis svar har en af disse statuskoder.
• RelativePath: Hvis du angiver denne værdi som tekst, føjes den til den grundlæggende URL-adresse, før du foretager anmodningen.

HTTP-anmodningen foretages med METODEN HEAD. Uden for en brugerdefineret dataconnectorkontekst er der kun et undersæt af svarheadere tilgængelige (af sikkerhedsmæssige årsager).

Eksempel 1

Hent HTTP-headere til "https://bing.com/search?q=Power+Query" brug af indstillingerne RelativePath og Query.

Brug

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

Output

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