Перейти к основному содержимому

Web.Headers

Возвращает заголовки HTTP, скачанные с URL-адреса, в качестве значения записи.

Syntax​

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

Remarks​

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

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

Examples​

Example #1​

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

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

Result:

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

Category​

Accessing data