Χειρισμός κωδικού κατάστασης με 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.