Web.Headers

Syntax

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

Info

Gibt die Header zurück, die von url als Datensatz heruntergeladen wurden. Der optionale Datensatzparameter (options) kann angegeben werden, um zusätzliche Eigenschaften anzugeben. Der Datensatz kann die folgenden Felder enthalten:

• Query: Fügen Sie der URL programmgesteuert Abfrageparameter hinzu, ohne sich um Escapezeichen kümmern zu müssen.
• ApiKeyName: Wenn die Zielwebsite einen API-Schlüssel vorsieht, kann mit diesem Parameter der Name (nicht der Wert) des Schlüsselparameters angegeben werden, der in der URL verwendet werden muss. Der tatsächliche Schlüsselwert wird in den Anmeldeinformationen bereitgestellt.
• Headers: Wenn Sie diesen Wert als Datensatz angeben, werden zusätzliche Header für eine HTTP-Anforderung bereitgestellt.
• Timeout: Wenn Sie diesen Wert als Zeitraum angeben, wird das Timeout einer HTTP-Anforderung geändert. Der Standardwert ist 100 Sekunden.
• ExcludedFromCacheKey: Wenn Sie diesen Wert als Liste angeben, werden diese HTTP-Headerschlüssel nicht in die Berechnung für das Zwischenspeichern von Daten einbezogen.
• IsRetry: Wenn Sie für diesen logischen Wert TRUE angeben, wird jede vorhandene Antwort im Cache beim Abrufen von Daten ignoriert.
• ManualStatusHandling: Wenn Sie diesen Wert als Liste angeben, wird jede integrierte Verarbeitung von HTTP-Anforderungen verhindert, deren Antwort einen dieser Statuscodes aufweist.
• RelativePath: Wenn Sie diesen Wert als Text angeben, wird der Wert an die Basis-URL angefügt, bevor die Anforderung gestellt wird.

Die HTTP-Anforderung erfolgt mit der HEAD-Methode. Außerhalb eines benutzerdefinierten Datenconnectors ist nur eine Teilmenge der Antwortheader verfügbar (aus Sicherheitsgründen).

Beispiel 1

Rufen Sie die HTTP-Header für "https://bing.com/search?q=Power+Query" mithilfe der Optionen „RelativePath“ und „Query“ ab.

Verwendung

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

Ausgabe

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