Przeczytaj w języku angielskim

Udostępnij za pośrednictwem


Web.Headers

Składnia

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

Około

Zwraca nagłówki pobrane z url jako rekord. Opcjonalny parametr rekordu, options, można podać, aby określić dodatkowe właściwości. Rekord może zawierać następujące pola:

  • Query: Programowe dodawanie parametrów zapytania do adresu URL bez konieczności martwienia się o ucieczkę.
  • ApiKeyName: jeśli witryna docelowa ma pojęcie klucza interfejsu API, ten parametr może służyć do określenia nazwy (a nie wartości) parametru klucza, który musi być używany w adresie URL. Rzeczywista wartość klucza jest podana w poświadczeniu.
  • Headers: określenie tej wartości jako rekordu spowoduje podanie dodatkowych nagłówków do żądania HTTP.
  • Timeout: określenie tej wartości jako czasu trwania spowoduje zmianę limitu czasu dla żądania HTTP. Wartość domyślna to 100 sekund.
  • ExcludedFromCacheKey: określenie tej wartości jako listy spowoduje wykluczenie tych kluczy nagłówka HTTP z części obliczeń dotyczących danych buforowania.
  • IsRetry: określenie tej wartości logicznej jako true spowoduje zignorowanie dowolnej istniejącej odpowiedzi w pamięci podręcznej podczas pobierania danych.
  • ManualStatusHandling: Podanie tej wartości jako listy uniemożliwi wszelką wbudowaną obsługę żądań HTTP, których odpowiedź ma jeden z tych kodów stanu.
  • RelativePath: określenie tej wartości jako tekstu powoduje dołączenie jej do podstawowego adresu URL przed wykonaniem żądania.

Żądanie HTTP jest wykonywane przy użyciu metody HEAD. Poza niestandardowym kontekstem łącznika danych dostępny jest tylko podzbiór nagłówków odpowiedzi (ze względów bezpieczeństwa).

Przykład 1

Pobierz nagłówki HTTP dla "https://bing.com/search?q=Power+Query" przy użyciu opcji RelativePath i Query.

Użycie

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

Wyjście

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