Web.Headers

  • Artikel
  • 2 minuter för att läsa

Syntax

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

Om

Returnerar de rubriker som laddats ned från url som en post. Ytterligare egenskaper kan anges genom att en valfri postparameter, options, tillhandahålls. Posten kan innehålla följande fält:

  • Query: Lägg programmässigt till frågeparametrar i URL:en utan att behöva oroa dig för undantag.
  • ApiKeyName: Om målplatsen har ett begrepp för en API-nyckel kan den här parametern användas för att ange namnet (inte värdet) för den nyckelparameter som måste användas i URL:en. Det faktiska nyckelvärdet anges i autentiseringsuppgiften.
  • Headers: Om du anger det här värdet som en post skapas fler huvuden i en HTTP-begäran.
  • Timeout: Om du anger det här värdet som en varaktighet ändras tidsgränsen för en HTTP-begäran. Standardvärdet är 100 sekunder.
  • ExcludedFromCacheKey: Om du anger det här värdet som en lista kommer dessa HTTP-huvudnycklar inte att ingå i beräkningen för cachelagring av data.
  • IsRetry: Om du anger det här logiska värdet som sant ignoreras eventuellt befintligt svar i cacheminnet vid hämtning av data.
  • ManualStatusHandling: Om du anger det här värdet som en lista förhindras all inbyggd hantering för HTTP-begäranden vars svar har en av dessa statuskoder.
  • RelativePath: Om du anger det här värdet som text läggs det till i bas-URL:en innan begäran görs.

HTTP-begäran görs med HEAD-metoden. Utanför en anpassad dataanslutningskontext är endast en delmängd av svarshuvuden tillgängliga (av säkerhetsskäl).

Exempel 1

Hämta HTTP-huvudena för "https://bing.com/search?q=Power+Query" att använda alternativen RelativePath och Query.

Användning

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

Resultat

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