อ่านในภาษาอังกฤษ

แชร์ผ่าน


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: การระบุค่าตรรกะนี้เป็นค่าจริง จะละเว้นการตอบกลับใด ๆ ที่มีอยู่ในแคชเมื่อดึงข้อมูล
  • ManualStatusHandling: การระบุค่านี้เป็นรายการ จะป้องกันไม่ให้มีการจัดการภายในระบบใด ๆ สําหรับคําขอ HTTP ที่มีการตอบสนองหนึ่งในรหัสสถานะเหล่านี้
  • RelativePath: การระบุค่านี้เป็นข้อความ จะผนวกเข้ากับ URL พื้นฐานก่อนทําการร้องขอ

คําขอ HTTP ถูกทําด้วยวิธีการ HEAD นอกขอบเขตของบริบทตัวเชื่อมต่อข้อมูลแบบกําหนดเอง จะมีเฉพาะชุดย่อยของส่วนหัวการตอบสนองเท่านั้น (เพื่อเหตุผลด้านความปลอดภัย)

ตัวอย่างที่ 1

ดึงข้อมูลส่วนหัว 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
])