Κοινή χρήση μέσω

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 από τη συμμετοχή στον υπολογισμό των δεδομένων στο cache.
  • IsRetry: Εάν καθορίσετε αυτή τη λογική τιμή ως "true", θα παραβλέψετε οποιαδήποτε υπάρχουσα απόκριση στο cache κατά τη λήψη δεδομένων.
  • 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
])