Partager via

Web.Headers

  • Article

Syntaxe

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

À propos de

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

  • Query : ajoutez par programmation les paramètres de la requête à l’URL sans vous soucier du caractère d’échappement.
  • ApiKeyName : si le site cible utilise une clé d’API, ce paramètre peut être utilisé pour spécifier le nom (pas 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 : si cette valeur est spécifiée en tant qu’enregistrement, des en-têtes supplémentaires sont fournis à une requête HTTP.
  • Timeout : si cette valeur est spécifiée en tant que durée, le délai pour une requête HTTP change. La valeur par défaut est de 100 secondes.
  • ExcludedFromCacheKey : si cette valeur est spécifiée en tant que liste, ces clés d’en-tête HTTP sont exclues du calcul pour la mise en cache des données.
  • IsRetry : si cette valeur logique est spécifiée en tant que valeur true, les réponses existantes dans le cache sont ignorées durant la récupération des données.
  • ManualStatusHandling : si cette valeur est spécifiée en tant que liste, cela empêche la gestion intégrée des requêtes HTTP dont la réponse correspond à l’un des codes d’état indiqués.
  • RelativePath : si cette valeur est spécifiée en tant que texte, elle est ajoutée à l’URL de base avant d’effectuer la demande.

La requête HTTP est effectuée à l’aide de 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" avec les options RelativePath et Query.

Utilisation

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

Sortie

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