Web.Headers

Syntaxe

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

À propos

Retourne les en-têtes téléchargés à partir d’un url enregistrement. Un paramètre d’enregistrement facultatif peut optionsêtre fourni pour spécifier des propriétés supplémentaires. L’enregistrement peut contenir les champs suivants :

• Query: ajoutez par programmation des paramètres de requête à l’URL sans avoir à vous soucier de l’échappement.
• ApiKeyName: si le site cible a une notion de clé API, ce paramètre peut être utilisé pour spécifier le nom (et non la valeur) du paramètre de clé qui doit être utilisé dans l’URL. La valeur de clé réelle est fournie dans les informations d’identification.
• Headers: la spécification de cette valeur en tant qu’enregistrement fournit des en-têtes supplémentaires à une requête HTTP.
• Timeout: la spécification de cette valeur en tant que durée modifie le délai d’expiration d’une requête HTTP. La valeur par défaut est de 100 secondes.
• ExcludedFromCacheKey: la spécification de cette valeur en tant que liste exclut ces clés d’en-tête HTTP de faire partie du calcul pour la mise en cache des données.
• IsRetry: la spécification de cette valeur logique comme true ignore toute réponse existante dans le cache lors de l’extraction de données.
• ManualStatusHandling: la spécification de cette valeur en tant que liste empêche toute gestion intégrée des requêtes HTTP dont la réponse comporte l’un de ces codes d’état.
• RelativePath: la spécification de cette valeur en tant que texte l’ajoute à l’URL de base avant d’effectuer la requête.

La requête HTTP est effectuée avec la méthode HEAD. En dehors d’un contexte de connecteur de données personnalisé, seul un sous-ensemble d’en-têtes de réponse est disponible (pour des raisons de sécurité).

Exemple 1

Récupérez les en-têtes HTTP pour "https://bing.com/search?q=Power+Query" utiliser les options RelativePath et Requête.

Utilisation

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

Output

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