Lue englanniksi

Jaa


Web.Headers

Syntaksi

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

Tietoja

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

  • Query: lisää kyselyparametrit ohjelmallisesti URL-osoitteeseen niin, ettei ohjausmerkkejä 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

Hae HTTP-otsikot "https://bing.com/search?q=Power+Query" relativepath- ja kyselyasetusten avulla.

Käyttö

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

Tuloste

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