Bagikan melalui

Web.Headers

  • Artikel

Sintaks

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

Tentang

Mengembalikan header yang diunduh dari url sebagai rekaman. Parameter rekaman opsional, options, dapat disediakan untuk menentukan properti tambahan. Catatan bisa berisi bidang berikut ini:

  • Query: Tambahkan parameter kueri secara terprogram ke URL tanpa harus khawatir tentang melarikan diri.
  • ApiKeyName: Jika situs target memiliki gagasan kunci API, parameter ini dapat digunakan untuk menentukan nama (bukan nilai) parameter kunci yang harus digunakan dalam URL. Nilai kunci aktual disediakan dalam kredensial.
  • Headers: Menentukan nilai ini sebagai rekaman akan menyediakan header tambahan ke permintaan HTTP.
  • Timeout: Menentukan nilai ini sebagai durasi akan mengubah batas waktu untuk permintaan HTTP. Nilai defaultnya adalah 100 detik.
  • ExcludedFromCacheKey: Menentukan nilai ini sebagai daftar akan mengecualikan kunci header HTTP ini agar tidak menjadi bagian dari perhitungan untuk penembolokan data.
  • IsRetry: Menentukan nilai logis ini sebagai true akan mengabaikan respons yang ada dalam cache saat mengambil data.
  • ManualStatusHandling: Menentukan nilai ini sebagai daftar akan mencegah penanganan bawaan untuk permintaan HTTP yang responsnya memiliki salah satu kode status ini.
  • RelativePath: Menentukan nilai ini sebagai teks menambahkannya ke URL dasar sebelum membuat permintaan.

Permintaan HTTP dibuat dengan metode HEAD. Di luar konteks konektor data kustom, hanya subkumpulan header respons yang tersedia (karena alasan keamanan).

Contoh 1

Ambil header HTTP untuk "https://bing.com/search?q=Power+Query" menggunakan opsi RelativePath dan Query.

Penggunaan

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

Hasil

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