Web.Headers

Sintaxis

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

Acerca de

Devuelve los encabezados descargados de url como un registro. Se puede proporcionar un parámetro de registro opcional, options, para especificar más propiedades. El registro puede contener los campos siguientes:

• Query: agrega parámetros de consulta a la dirección URL mediante programación sin tener que preocuparse por los escapes.
• ApiKeyName: si el sitio de destino tiene una noción de una clave de API, este parámetro se puede usar para especificar el nombre (no el valor) del parámetro clave que se debe usar en la dirección URL. El valor de clave real se proporciona en la credencial.
• Headers: si se especifica este valor como un registro, se proporcionarán más encabezados a una solicitud HTTP.
• Timeout: si se especifica este valor como una duración, se cambiará el tiempo de espera de una solicitud HTTP. El valor predeterminado es 100 segundos.
• ExcludedFromCacheKey: si se especifica este valor como una lista, se excluirán estas claves de encabezado HTTP de formar parte del cálculo para almacenar datos en caché.
• IsRetry: si se especifica este valor lógico como true, se pasará por alto cualquier respuesta existente almacenada en la memoria caché al obtener datos.
• ManualStatusHandling: si se especifica este valor como una lista, se impedirá cualquier control integrado de las solicitudes HTTP cuya respuesta tenga uno de estos códigos de estado.
• RelativePath: si se especifica este valor como texto, se anexa a la dirección URL base antes de realizar la solicitud.

La solicitud HTTP se realiza con el método HEAD. Fuera de un contexto de conector de datos personalizado, solo hay disponible un subconjunto de encabezados de respuesta (por motivos de seguridad).

Ejemplo 1

Recupere los encabezados HTTP de "https://bing.com/search?q=Power+Query" usando las opciones RelativePath y Query.

Uso

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

Salida

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