Web.Headers

Syntax

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

Névjegy

A rekordként letöltött url fejléceket adja vissza. További tulajdonságok megadásához megadható egy opcionális rekordparaméter options. A rekord a következő mezőket tartalmazhatja:

• Query: Programozott módon adjon hozzá lekérdezési paramétereket az URL-címhez anélkül, hogy a meneküléssel kellene foglalkoznia.
• ApiKeyName: Ha a célhelyen van egy API-kulcs fogalma, ez a paraméter az URL-ben használandó kulcsparaméter nevét (nem az értékét) adhatja meg. A tényleges kulcsértéket a hitelesítő adatok adják meg.
• Headers: Ha rekordként adja meg ezt az értéket, további fejléceket fog megadni egy HTTP-kéréshez.
• Timeout: Ha ezt az értéket időtartamként adja meg, az megváltoztatja a HTTP-kérések időtúllépését. Az alapértelmezett érték 100 másodperc.
• ExcludedFromCacheKey: Ha ezt az értéket listaként adja meg, az kizárja, hogy ezek a HTTP-fejléckulcsok az adatok gyorsítótárazási számításának részei legyenek.
• IsRetry: Ha ezt a logikai értéket igaz értékként adja meg, az adatok beolvasásakor figyelmen kívül hagyja a gyorsítótárban lévő összes meglévő választ.
• ManualStatusHandling: Ha ezt az értéket listaként adja meg, az megakadályozza azoknak a HTTP-kéréseknek a beépített kezelését, amelyek válasza az alábbi állapotkódok egyikével rendelkezik.
• RelativePath: Ha ezt az értéket szövegként adja meg, a kérés előtt hozzáfűzi az alap URL-címhez.

A HTTP-kérés a HEAD metódussal történik. Az egyéni adatösszekötő-környezeten kívül csak a válaszfejlécek egy részhalmaza érhető el (biztonsági okokból).

1\. példa

Kérje le a HTTP-fejléceket a RelativePath és a Query beállításainak "https://bing.com/search?q=Power+Query" használatához.

Használat

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

Hozam

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