Web.Headers

Синтаксис

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

О нас

Возвращает заголовки, скачанные из url в виде записи. Необязательный параметр записи, options, может быть предоставлен для указания дополнительных свойств. Запись может содержать следующие поля:

• Query. Программное добавление параметров запроса в URL-адрес без необходимости беспокоиться о выходе.
• ApiKeyName. Если целевой сайт имеет понятие ключа API, этот параметр можно использовать для указания имени (не значения) параметра ключа, который должен использоваться в URL-адресе. Фактическое значение ключа указывается в учетных данных.
• Headers. Указание этого значения в качестве записи приведет к добавлению дополнительных заголовков в HTTP-запрос.
• Timeout. Указание этого значения в качестве длительности приведет к изменению времени ожидания HTTP-запроса. Значение по умолчанию — 100 секунд.
• ExcludedFromCacheKey. Указание этого значения в виде списка исключает эти ключи заголовка HTTP из части вычисления для кэширования данных.
• IsRetry. Указание этого логического значения как true будет игнорировать любой существующий ответ в кэше при получении данных.
• ManualStatusHandling. Указание этого значения в качестве списка приведет к предотвращению любой встроенной обработки HTTP-запросов, ответ которых имеет один из этих кодов состояния.
• RelativePath. Указание этого значения в виде текста добавляет его к базовому URL-адресу перед выполнением запроса.

HTTP-запрос выполняется с помощью метода HEAD. Вне контекста пользовательского соединителя данных доступно только подмножество заголовков ответов (по соображениям безопасности).

Пример

Получите заголовки HTTP для "https://bing.com/search?q=Power+Query" с помощью параметров RelativePath и Query.

использование

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

вывод

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