Del via

Web.Headers

  • Artikkel

Syntaks

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

Om

Returnerer topptekstene som lastes ned fra url som en post. En valgfri postparameter, options, kan angi flere egenskaper. Posten kan inneholde følgende felt:

  • Query: Legg programmatisk til spørringsparametere i nettadressen uten å måtte bekymre deg for å slippe unna.
  • ApiKeyName: Hvis målområdet har en forestilling om en API-nøkkel, kan denne parameteren brukes til å angi navnet (ikke verdien) for nøkkelparameteren som må brukes i URL-adressen. Den faktiske nøkkelverdien angis i legitimasjonen.
  • Headers: Hvis du angir denne verdien som en post, får du flere overskrifter til en HTTP-forespørsel.
  • Timeout: Hvis du angir denne verdien som en varighet, endres tidsavbruddet for en HTTP-forespørsel. Standardverdien er 100 sekunder.
  • ExcludedFromCacheKey: Hvis du angir denne verdien som en liste, utelates disse HTTP-topptekstnøklene fra å være en del av beregningen for hurtigbufring av data.
  • IsRetry: Hvis du angir denne logiske verdien som sann, ignoreres alle eksisterende svar i hurtigbufferen når du henter data.
  • ManualStatusHandling: Hvis du angir denne verdien som en liste, forhindres innebygd håndtering for HTTP-forespørsler hvis svar har én av disse statuskodene.
  • RelativePath: Hvis du angir denne verdien som tekst, føyer den til den grunnleggende URL-adressen før du foretar forespørselen.

HTTP-forespørselen utføres med HEAD-metoden. Utenfor en egendefinert datakoblingskontekst er bare et delsett av svaroverskrifter tilgjengelig (av sikkerhetsgrunner).

Eksempel 1

Hent HTTP-overskriftene for "https://bing.com/search?q=Power+Query" ved hjelp av alternativene RelativePath og Spørring.

bruk

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

utdata

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