Web.Headers

Sintaxis

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

Acerca de

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

• Query: agregue mediante programación parámetros de consulta a la dirección URL sin tener que preocuparse por el escape.
• 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 de clave que se debe usar en la dirección URL. El valor real de la clave se proporciona en la credencial.
• Headers: si se especifica este valor como registro, se proporcionarán encabezados adicionales 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: Especificar este valor como una lista excluirá estas claves de encabezado HTTP de formar parte del cálculo para los datos de caché.
• IsRetry: si se especifica este valor lógico como true, se omitirá cualquier respuesta existente en la memoria caché al capturar datos.
• ManualStatusHandling: si se especifica este valor como una lista, se impedirá el control integrado de las solicitudes HTTP cuya respuesta tenga uno de estos códigos de estado.
• RelativePath: Especificar este valor como texto lo anexa a la URL de 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 para "https://bing.com/search?q=Power+Query" mediante 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
])