Web.Headers

Syntaxis

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

Info

Retourneert de headers die zijn gedownload van url als een record. Er kan een optionele recordparameter optionsworden opgegeven om extra eigenschappen op te geven. De record kan de volgende velden bevatten:

• Query: Programmatisch queryparameters toevoegen aan de URL zonder dat u zich zorgen hoeft te maken over escapen.
• ApiKeyName: Als de doelsite een notie van een API-sleutel heeft, kan deze parameter worden gebruikt om de naam (niet de waarde) op te geven van de sleutelparameter die moet worden gebruikt in de URL. De werkelijke sleutelwaarde wordt opgegeven in de referentie.
• Headers: Als u deze waarde opgeeft als een record, worden extra headers aan een HTTP-aanvraag toegevoegd.
• Timeout: Als u deze waarde opgeeft als een duur, wordt de time-out voor een HTTP-aanvraag gewijzigd. De standaardwaarde is 100 seconden.
• ExcludedFromCacheKey: Als u deze waarde opgeeft als een lijst, worden deze HTTP-headersleutels uitgesloten van een deel van de berekening voor het opslaan van gegevens in de cache.
• IsRetry: Als u deze logische waarde opgeeft als waar, worden bestaande reacties in de cache genegeerd bij het ophalen van gegevens.
• ManualStatusHandling: Als u deze waarde opgeeft als een lijst, voorkomt u ingebouwde verwerking voor HTTP-aanvragen waarvan het antwoord een van deze statuscodes heeft.
• RelativePath: Als u deze waarde opgeeft als tekst, wordt deze toegevoegd aan de basis-URL voordat u de aanvraag indient.

De HTTP-aanvraag wordt gedaan met de HEAD-methode. Buiten de context van een aangepaste gegevensconnector is alleen een subset van antwoordheaders beschikbaar (om veiligheidsredenen).

Voorbeeld 1

Haal de HTTP-headers op voor "https://bing.com/search?q=Power+Query" het gebruik van de opties RelativePath en Query.

Gebruik

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

Uitvoer

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