Leggere in inglese

Condividi tramite


Web.Headers

Sintassi

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

Informazioni su

Restituisce le intestazioni scaricate da url come record. È possibile fornire un parametro di record facoltativo, options, per specificare proprietà aggiuntive. Il record può contenere i campi seguenti:

  • Query: aggiungere parametri di query a livello di codice all'URL senza doversi preoccupare dell'escape.
  • ApiKeyName: se il sito di destinazione riconosce una chiave API, questo parametro può essere usato per specificare il nome, non il valore, del parametro chiave che deve essere usato nell'URL. Il valore di chiave effettivo viene specificato nella credenziale.
  • Headers: se si specifica questo valore come record, verranno fornite intestazioni aggiuntive a una richiesta HTTP.
  • Timeout: se si specifica questo valore come durata, verrà modificato il timeout per una richiesta HTTP. Il valore predefinito è 100 secondi.
  • ExcludedFromCacheKey: se si specifica questo valore come elenco, le chiavi di intestazione HTTP verranno escluse dal calcolo per la memorizzazione dei dati nella cache.
  • IsRetry: se si specifica questo valore logico come true, durante il recupero dei dati verrà ignorata qualsiasi risposta esistente nella cache.
  • ManualStatusHandling: se si specifica questo valore come elenco, si eviterà la gestione predefinita per le richieste HTTP la cui risposta presenta uno di questi codici di stato.
  • RelativePath: se si specifica questo valore come testo, questo viene aggiunto all'URL di base prima di effettuare la richiesta.

La richiesta HTTP viene effettuata con il metodo HEAD. Al di fuori di un contesto del connettore dati personalizzato, è disponibile solo un subset di intestazioni di risposta (per motivi di sicurezza).

Esempio 1

Recuperare le intestazioni HTTP per "https://bing.com/search?q=Power+Query" l'uso delle opzioni RelativePath e Query.

Utilizzo

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
])