Partilhar via

Web.Headers

  • Artigo

Sintaxe

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

Sobre nós

Retorna os cabeçalhos baixados do url como um registro. Um parâmetro de registro opcional, options, pode ser fornecido para especificar propriedades adicionais. O registo pode conter os seguintes campos:

  • Query: Adicione programaticamente parâmetros de consulta ao URL sem ter que se preocupar em escapar.
  • ApiKeyName: Se o site de destino tiver uma noção de uma chave de API, esse parâmetro pode ser usado para especificar o nome (não o valor) do parâmetro de chave que deve ser usado na URL. O valor real da chave é fornecido na credencial.
  • Headers: Especificar esse valor como um registro fornecerá cabeçalhos adicionais para uma solicitação HTTP.
  • Timeout: Especificar esse valor como uma duração alterará o tempo limite de uma solicitação HTTP. O valor padrão é 100 segundos.
  • ExcludedFromCacheKey: Especificar esse valor como uma lista excluirá essas chaves de cabeçalho HTTP de fazerem parte do cálculo para armazenar dados em cache.
  • IsRetry: Especificar esse valor lógico como true ignorará qualquer resposta existente no cache ao buscar dados.
  • ManualStatusHandling: Especificar esse valor como uma lista impedirá qualquer manipulação interna para solicitações HTTP cuja resposta tenha um desses códigos de status.
  • RelativePath: Especificar esse valor como texto o acrescenta à URL base antes de fazer a solicitação.

A solicitação HTTP é feita com o método HEAD. Fora de um contexto de conector de dados personalizado, apenas um subconjunto de cabeçalhos de resposta está disponível (por motivos de segurança).

Exemplo 1

Recupere os cabeçalhos HTTP para "https://bing.com/search?q=Power+Query" usando as opções RelativePath e Query.

Utilização

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

Saída

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