Skip to main content

Web.Headers

Atgriež HTTP galvenes, kas lejupielādētas no vietrāža URL kā ieraksta vērtība.

Syntax​

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

Remarks​

Tiek atgrieztas galvenes, kas lejupielādētas no url kā ieraksts. Lai norādītu papildu rekvizītus, options var norādīt neobligātu ieraksta parametru. Ierakstā var būt šādi lauki:

  • Query : Programmiski pievienojiet vaicājuma parametrus vietrādim URL, neraizējoties par atkāpi.
  • ApiKeyName : Ja mērķa vietnei ir priekšstats par API atslēgu, šo parametru var izmantot, lai norādītu vietrādī URL izmantojamo atslēgas parametra nosaukumu (nevis vērtību). Faktiskā atslēgas vērtība ir norādīta akreditācijas datos.
  • Headers : Norādot šo vērtību kā ierakstu, HTTP pieprasījumam tiks nodrošinātas papildu galvenes.
  • Timeout : Norādot šo vērtību kā ilgumu, tiks mainīts HTTP pieprasījuma taimauts. Noklusējuma vērtība ir 100 sekundes.
  • ExcludedFromCacheKey : Norādot šo vērtību kā sarakstu, šīs HTTP galvenes atslēgas tiks izslēgtas no datu kešdarbes aprēķina daļas.
  • IsRetry : Ja norādīsit šo loģisko vērtību kā true (patiess), ienesot datus, tiks ignorētas visas kešatmiņā esošās atbildes.
  • ManualStatusHandling : Norādot šo vērtību kā sarakstu, netiks pieļauta jebkāda iebūvētā apstrāde tiem HTTP pieprasījumiem, kuru atbilde ir viens no šiem statusa kodiem.
  • RelativePath : Norādot šo vērtību kā tekstu, pirms pieprasījuma veikšanas tas tiek pievienots pamata vietrādim URL.

HTTP pieprasījums ir veikts, izmantojot metodi HEAD. Ārpus pielāgota datu savienotāja konteksta ir pieejama tikai atbildes galveņu apakškopa (drošības apsvērumu dēļ).

Examples​

Example #1​

Izgūstiet HTTP galvenes "https://bing.com/search?q=Power+Query", izmantojot opcijas RelativePath un Query.

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

Result:

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

Category​

Accessing data