Partilhar via

Web.Cabeçalhos

  • Artigo

Sintaxe

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

Acerca de

Retorna os cabeçalhos baixados url como um registro. Um parâmetro de registro opcional, , optionspode 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" usar 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
])