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

Χειρισμός κωδικού κατάστασης με Web.Contents

  • Άρθρο

Η Web.Contents συνάρτηση διαθέτει ορισμένες ενσωματωμένες λειτουργίες για τον χειρισμό ορισμένων κωδικών κατάστασης HTTP. Η προεπιλεγμένη συμπεριφορά μπορεί να παρακαμπιστεί στην επέκτασή σας χρησιμοποιώντας το ManualStatusHandling πεδίο στην εγγραφή επιλογών.

Αυτόματη επανάληψη

Web.Contents Θα επαναλάβει αυτόματα αιτήσεις που αποτυγχάνουν με έναν από τους ακόλουθους κωδικούς κατάστασης:

Κωδικός Status
408 Χρονικό όριο αίτησης
429 Πάρα πολλές αιτήσεις
503 Η υπηρεσία δεν είναι διαθέσιμη
504 Χρονικό όριο πύλης
509 Υπέρβαση ορίου εύρους ζώνης

Οι αιτήσεις θα επαναληφθούν έως τρεις φορές προτού αποτύχουν. Ο μηχανισμός χρησιμοποιεί έναν αλγόριθμο εκθετικής επαναφοράς για να προσδιορίσει τον χρόνο αναμονής μέχρι την επόμενη επανάληψη, εκτός εάν η απόκριση περιέχει μια Retry-after κεφαλίδα. Όταν βρεθεί η κεφαλίδα, ο μηχανισμός θα περιμένει τον καθορισμένο αριθμό δευτερολέπτων πριν από την επόμενη επανάληψη. Ο ελάχιστος υποστηριζόμενος χρόνος αναμονής είναι 0,5 δευτερόλεπτα και η μέγιστη τιμή είναι 120 δευτερόλεπτα.

Σημείωμα

Η Retry-after τιμή πρέπει να έχει τη delta-seconds μορφή. Η HTTP-date μορφή δεν υποστηρίζεται προς το παρόν.

Εξαιρέσεις ελέγχου ταυτότητας

Οι ακόλουθοι κωδικοί κατάστασης θα έχουν ως αποτέλεσμα μια εξαίρεση διαπιστευτηρίων, προκαλώντας μια προτροπή ελέγχου ταυτότητας ζητώντας από το χρήστη να καταχωρήσει διαπιστευτήρια (ή να εισέλθει ξανά στην περίπτωση λήξης διακριτικού OAuth).

Κωδικός Status
401 Χωρίς εξουσιοδότηση
403 Δεν επιτρέπεται

Σημείωμα

Οι επεκτάσεις μπορούν να χρησιμοποιήσουν την ManualStatusHandling επιλογή με τους κωδικούς κατάστασης 401 και 403, το οποίο δεν είναι κάτι που μπορεί να γίνει σε Web.Contents κλήσεις που γίνονται εκτός μιας προσαρμοσμένης σύνδεσης δεδομένων (δηλαδή, απευθείας από το Power Query).

Ανακατεύθυνση

Οι ακόλουθοι κωδικοί κατάστασης θα έχουν ως αποτέλεσμα μια αυτόματη ανακατεύθυνση στο URI που καθορίζεται στην Location κεφαλίδα. Μια κεφαλίδα που λείπει Location θα έχει ως αποτέλεσμα ένα σφάλμα.

Κωδικός Status
300 Πολλαπλές επιλογές
301 Οριστική μετακίνηση
302 Βρέθηκαν
303 Εμφάνιση άλλων
307 Προσωρινή ανακατεύθυνση

Σημείωμα

Μόνο ο κωδικός κατάστασης 307 θα διατηρήσει μια POST μέθοδο αίτησης. Όλοι οι άλλοι κωδικοί κατάστασης ανακατεύθυνσης θα έχουν ως αποτέλεσμα τη μετάβαση σε GET.