Les på engelsk

Del via


Web.Headers

Syntaks

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

Om

Returnerer overskriftene som lastes ned fra url som en post. Det kan være angitt en valgfri postparameter optionsfor å 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 eventuelle 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 som har en 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" bruk 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
])