Jaa

Web.Headers

  • Artikkeli

Syntaksi

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

Noin

Palauttaa url ladatut otsikot tietueena. Valinnainen tietueparametri optionsvoidaan antaa määrittämään lisäominaisuuksia. Tietue voi sisältää seuraavat kentät:

  • Query: Lisää kyselyparametreja ohjelmallisesti URL-osoitteeseen niin, ettei ohjauskopiosta tarvitse huolehtia.
  • ApiKeyName: Jos kohdesivustolla on käsitys API-avaimesta, tämän parametrin avulla voidaan määrittää URL-osoitteessa käytettävän avainparametrin nimi (ei arvo). Todellinen avainarvo annetaan tunnistetiedoissa.
  • Headers: Tämän arvon määrittäminen tietueena antaa lisäotsikot HTTP-pyynnölle.
  • Timeout: Tämän arvon määrittäminen kestona muuttaa HTTP-pyynnön aikakatkaisun. Oletusarvo on 100 sekuntia.
  • ExcludedFromCacheKey: Tämän arvon määrittäminen luettelona jättää pois nämä HTTP-otsikkoavaimet tietojen välimuistiin tallentamisen laskutoimituksesta.
  • IsRetry: Tämän loogisen arvon määrittäminen arvona tosi ohittaa välimuistissa olevan mahdollisen vastauksen tietoja noudettaessa.
  • ManualStatusHandling: Tämän arvon määrittäminen luettelona estää sellaisten HTTP-pyyntöjen sisäiset käsittelyt, joiden vastauksella on jokin näistä tilakoodeista.
  • RelativePath: Tämän arvon määrittäminen tekstinä lisää sen URL-perusosoitteeseen ennen pyynnön tekemistä.

HTTP-pyyntö tehdään HEAD-menetelmällä. Mukautetun tietoyhdistimen kontekstin ulkopuolella käytettävissä on vain vastausotsikoiden alijoukko (suojaussyistä).

Esimerkki 1

Nouda "https://bing.com/search?q=Power+Query" HTTP-otsikot RelativePath- ja Query-asetuksista.

käyttö

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
])