Skip to main content
ΑρχικήΙστολόγιοΟδηγοίΈληξε το χρονικό όριο του αιτήματος παρακολούθησης σε πραγματικό χρόνο; Κανόνες επανάληψης, εναλλακτικής λειτουργίας και κατάστασης που πρέπει να ακολουθήσετε

Έληξε το χρονικό όριο του αιτήματος παρακολούθησης σε πραγματικό χρόνο; Κανόνες επανάληψης, εναλλακτικής λειτουργίας και κατάστασης που πρέπει να ακολουθήσετε

17TRACK

Όταν ένα αίτημα παρακολούθησης σε πραγματικό χρόνο λήγει, θεωρήστε την πιο πρόσφατη κατάσταση της αποστολής άγνωστη — όχι καθυστερημένη, χαμένη ή αμετάβλητη. Επαναλάβετε την προσπάθεια μόνο εντός ενός περιορισμένου χρονικού ορίου και, στη συνέχεια, εμφανίστε μια σαφώς επισημασμένη τελευταία γνωστή ενημέρωση ή ζητήστε από τον χρήστη να ελέγξει ξανά αργότερα. Διατηρείτε ξεχωριστά καθ’ όλη τη διαδικασία το αποτέλεσμα του αιτήματος, την επικαιρότητα των δεδομένων και την πραγματική κατάσταση του δέματος.

Το αίτημα παρακολούθησης σε πραγματικό χρόνο έληξε: επανάληψη, εναλλακτική λύση και κατάσταση

Αυτή η διάκριση έχει σημασία τόσο για τις σελίδες παρακολούθησης που απευθύνονται στους πελάτες όσο και για τα συστήματα που χρησιμοποιούν δεδομένα παρακολούθησης για την ενεργοποίηση ειδοποιήσεων ή ροών εργασίας υποστήριξης. Η λήξη χρόνου σάς ενημερώνει ότι μια απάντηση δεν έφτασε εγκαίρως. Δεν σας ενημερώνει αν ο μεταφορέας έχει νέο συμβάν, αν μια ανάντη υπηρεσία επεξεργάστηκε το αίτημα ή αν το δέμα έχει μετακινηθεί.

Αρχικά, εντοπίστε τι έληξε

Ένα αίτημα παρακολούθησης μπορεί να αποτύχει σε αρκετά σημεία: το πρόγραμμα περιήγησης μπορεί να σταματήσει να περιμένει την εφαρμογή σας, η εφαρμογή σας μπορεί να σταματήσει να περιμένει ένα API παρακολούθησης ή το συγκεκριμένο API μπορεί να λήξει κατά την επικοινωνία με μια άλλη υπηρεσία. Ο χρήστης μπορεί να βλέπει το ίδιο γενικό σφάλμα σε κάθε περίπτωση, όμως η κατάλληλη επόμενη ενέργεια διαφέρει.

  • Λήξη χρόνου στην πλευρά του πελάτη: Η εφαρμογή σταμάτησε να περιμένει. Το αίτημα στην πλευρά του διακομιστή μπορεί να έχει ολοκληρωθεί. Ελέγξτε τα δικά σας αρχεία καταγραφής αιτημάτων ή το αποθετήριο αποτελεσμάτων πριν εκδώσετε νέο αίτημα που θα μπορούσε να δημιουργήσει διπλή εργασία.
  • Αποτυχία δικτύου ή σύνδεσης: Το σύστημά σας δεν έλαβε αξιοποιήσιμη απάντηση. Ενδέχεται να μην γνωρίζετε αν η απομακρυσμένη υπηρεσία επεξεργάστηκε το αίτημα.
  • HTTP 504: Μια πύλη ή ένας διακομιστής μεσολάβησης δεν έλαβε έγκαιρη απάντηση από έναν ανάντη διακομιστή. Αυτό περιγράφει τη διαδρομή του αιτήματος, όχι την αποστολή.
  • HTTP 408: Ο διακομιστής δεν έλαβε πλήρες μήνυμα αιτήματος εντός του χρόνου που ήταν διατεθειμένος να περιμένει. Δεν αποτελεί κατάσταση παρακολούθησης από τον μεταφορέα.
  • HTTP 200 με παλιό συμβάν: Το αίτημα ολοκληρώθηκε επιτυχώς, όμως οι πληροφορίες παρακολούθησης που επιστράφηκαν μπορεί να μην είναι επικαιροποιημένες. Μια επιτυχής απόκριση HTTP δεν αποτελεί εγγύηση επικαιρότητας.

Καταγράψτε αυτά τα αποτελέσματα ως διαγνωστικά του αιτήματος. Μην μεταφράζετε κανένα από αυτά σε ετικέτες αποστολής όπως «σε μεταφορά», «εξαίρεση» ή «παραδόθηκε». Αυτές οι ετικέτες πρέπει να προέρχονται από συμβάντα παρακολούθησης ή από τεκμηριωμένο πεδίο κατάστασης και όχι από το επίπεδο μεταφοράς.

Χρησιμοποιήστε περιορισμένες επαναλήψεις, όχι βρόχο χωρίς τέλος

Για μια αναζήτηση παρακολούθησης μόνο για ανάγνωση, μια επανάληψη μετά από λήξη χρόνου είναι συχνά λογική. Παρ’ όλα αυτά, πρέπει να είναι περιορισμένη. Τα επαναλαμβανόμενα αιτήματα μπορούν να αυξήσουν το φορτίο σε μια υπηρεσία που αντιμετωπίζει προβλήματα, να παρατείνουν την αναμονή του χρήστη και να δημιουργήσουν διπλή εργασία όταν πολλά επίπεδα της εφαρμογής επαναλαμβάνουν ανεξάρτητα το αίτημα.

  1. Ορίστε συνολική προθεσμία. Αποφασίστε πόσο μπορεί να διαρκέσει η λειτουργία που βλέπει ο χρήστης, συμπεριλαμβανομένης της αρχικής προσπάθειας και κάθε επανάληψης. Μην δίνετε σε κάθε προσπάθεια νέα, πλήρη προθεσμία που υπερβαίνει τον χρόνο αναμονής του καλούντος.
  2. Ελέγξτε αν η λειτουργία είναι ασφαλές να επαναληφθεί. Μια αναζήτηση συνήθως διαφέρει από ένα αίτημα που καταχωρίζει αποστολή, αλλάζει ρυθμίσεις ή δημιουργεί πόρο. Μην επαναλαμβάνετε αυτόματα ένα αίτημα που αλλάζει κατάσταση, εκτός αν η σύμβαση του παρόχου ή οι έλεγχοι ιδ idempotency το καθιστούν ασφαλές.
  3. Επαναλάβετε μια προσωρινή αποτυχία με φειδώ. Χρησιμοποιήστε μικρό, σαφώς καθορισμένο προϋπολογισμό επαναλήψεων και καθυστέρηση με τυχαιότητα, αντί να στέλνετε ταυτόχρονες άμεσες επαναλήψεις από πολλούς πελάτες.
  4. Τηρήστε τις ισχύουσες οδηγίες του διακομιστή. Αν μια απόκριση περιλαμβάνει έγκυρη κεφαλίδα Retry-After, μην προγραμματίσετε νωρίτερη επανάληψη. Τηρήστε επίσης οποιοδήποτε αυστηρότερο όριο της εφαρμογής ή του παρόχου.
  5. Σταματήστε όταν εξαντληθεί η προθεσμία ή ο προϋπολογισμός. Μεταβείτε σε εναλλακτική απόκριση και προγραμματίστε ξεχωριστά μεταγενέστερη συμφιλίωση, αν τη χρειάζεται η ροή εργασίας σας.

Ένας πρακτικός σχεδιασμός μπορεί να επιτρέπει μία επανάληψη που βλέπει ο χρήστης, αν απομένει αρκετός χρόνος, ενώ μεταφέρει τις επόμενες προσπάθειες σε ανανέωση στο παρασκήνιο. Αυτό είναι παράδειγμα πολιτικής και όχι καθολικός κανόνας API. Επιλέξτε όρια με βάση τους στόχους επιπέδου υπηρεσίας, την παρατηρούμενη καθυστέρηση και την τεκμηρίωση του παρόχου. Συνυπολογίστε επίσης τις επαναλήψεις που πραγματοποιούνται από βιβλιοθήκες HTTP, πύλες και workers εργασιών· διαφορετικά, μια φαινομενικά μέτρια πολιτική εφαρμογής μπορεί να δημιουργήσει πολλές ανάντη κλήσεις.

Για το HTTP 429, αντιμετωπίστε την απόκριση ως σήμα περιορισμού ρυθμού και όχι ως λόγο για άμεση επανάληψη. Το HTTP 503 μπορεί να υποδεικνύει προσωρινή αδυναμία εξυπηρέτησης του αιτήματος και ο διακομιστής μπορεί να παρέχει Retry-After. Το 504 μπορεί να είναι προσωρινό, όμως δεν εγγυάται ότι η επόμενη προσπάθεια θα λειτουργήσει. Τα σφάλματα ελέγχου ταυτότητας απαιτούν γενικά έλεγχο διαπιστευτηρίων ή δικαιωμάτων, ενώ τα κακοσχηματισμένα αιτήματα απαιτούν διόρθωση εισόδου. Ένα αναγνωριστικό παρακολούθησης που επιστρέφει αποτέλεσμα «δεν βρέθηκε» χρειάζεται μεγαλύτερη προσοχή: ανάλογα με την τεκμηριωμένη συμπεριφορά του παρόχου και το στάδιο της αποστολής, μπορεί να είναι πολύ νωρίς για να βρεθεί εγγραφή ή το αναγνωριστικό μπορεί να είναι λανθασμένο. Μην μετατρέπετε ένα τέτοιο αποτέλεσμα σε οριστικό ισχυρισμό ότι το δέμα δεν υπάρχει.

Επιλέξτε εναλλακτική λύση που διατηρεί όσα γνωρίζετε

Η ασφαλέστερη εναλλακτική λύση είναι συνήθως το τελευταίο επαληθευμένο αποτέλεσμα παρακολούθησης, συνοδευόμενο από τη δική του ώρα συμβάντος και μια ειλικρινή ένδειξη επικαιρότητας. Διατηρήστε αυτό το αποτέλεσμα ξεχωριστό από την αποτυχία του τρέχοντος αιτήματος. Μια σελίδα μπορεί να αναφέρει: «Τελευταία διαθέσιμη ενημέρωση: Αναχώρησε από εγκατάσταση. Τελευταίος έλεγχος: [ώρα]. Μια νεότερη ενημέρωση δεν είναι προσωρινά διαθέσιμη». Συμπεριλάβετε την ένδειξη «Τελευταίος έλεγχος» μόνο αν το σύστημά σας την καταγράφει πραγματικά· δεν αντικαθιστά την ώρα του συμβάντος από τον μεταφορέα.

Χρησιμοποιήστε τον πιο συγκεκριμένο χρόνο που μπορείτε να υποστηρίξετε. Η ώρα συμβάντος του μεταφορέα περιγράφει πότε φέρεται να συνέβη ένα συμβάν. Η ώρα κατά την οποία το σύστημά σας έλαβε το συμβάν περιγράφει την εισαγωγή του. Η ώρα κατά την οποία ένας χρήστης άνοιξε τη σελίδα δεν περιγράφει κανένα από τα δύο. Αν η πηγή δεν παρέχει αξιόπιστη ώρα συμβάντος ή ζώνη ώρας, μην επινοείτε μία. Ομοίως, αν το αποθηκευμένο αποτέλεσμα δεν έχει καταγεγραμμένο χρόνο ανάκτησης, αποκαλέστε το «τελευταία διαθέσιμη ενημέρωση» αντί να ισχυριστείτε ότι ανανεώθηκε πρόσφατα.

Μια εναλλακτική λύση πρέπει να τηρεί τρία όρια:

  • Εμφανίζετε τα αποθηκευμένα δεδομένα ως αποθηκευμένα δεδομένα. Μην παρουσιάζετε ένα παλαιότερο συμβάν ως αποτέλεσμα του αιτήματος που έληξε.
  • Μην συμπεραίνετε πρόοδο από τον χρόνο που παρήλθε. Ένα δέμα δεν είναι «προς παράδοση» απλώς επειδή βρίσκεται σε μεταφορά για αρκετές ημέρες.
  • Μην αποκρύπτετε ουσιαστική αβεβαιότητα. Αν δεν υπάρχει προηγούμενο αποτέλεσμα, πείτε ότι η παρακολούθηση είναι προσωρινά μη διαθέσιμη αντί να εμφανίσετε μια επινοημένη προεπιλεγμένη κατάσταση.

Άλλες εναλλακτικές διαδρομές μπορεί να περιλαμβάνουν ένα προηγουμένως συγχρονισμένο αποθετήριο παρακολούθησης, μια εξουσιοδοτημένη αναζήτηση μεταφορέα ή μια μεταγενέστερη ανανέωση στο παρασκήνιο. Χρησιμοποιήστε τις μόνο αν ταιριάζουν στην αποστολή, στα δικαιώματά σας και στους όρους της πηγής δεδομένων. Μια δεύτερη πηγή μπορεί να έχει διαφορετικές ονομασίες συμβάντων ή καθυστερήσεις αναφοράς, επομένως διατηρήστε την προέλευση και αποφύγετε τη συγχώνευση αντικρουόμενων εγγραφών χωρίς κανόνα για αυτήν. Αν ένας πελάτης μπορεί να ενεργήσει βάσει του αποτελέσματος, προσφέρετε τρόπο επανάληψης ή επικοινωνίας με την υποστήριξη αντί να αφήνετε επ’ αόριστον έναν δείκτη φόρτωσης.

Διατηρήστε ξεχωριστές την κατάσταση αιτήματος, την επικαιρότητα δεδομένων και την κατάσταση αποστολής

Αυτά είναι τρία διαφορετικά πεδία, ακόμη κι αν μια διεπαφή χρήστη τα εμφανίζει μαζί. Η κατάσταση αιτήματος αναφέρει αν η αναζήτηση ολοκληρώθηκε επιτυχώς, έληξε ή έλαβε σφάλμα. Η επικαιρότητα δεδομένων αναφέρει πότε παρατηρήθηκαν οι πληροφορίες που επιστράφηκαν ή αποθηκεύτηκαν. Η κατάσταση αποστολής αναφέρει τι δηλώνει η πηγή παρακολούθησης για το δέμα. Ο διαχωρισμός τους εμποδίζει μια προσωρινή αποτυχία API να αντικαταστήσει ένα έγκυρο συμβάν παράδοσης ή να μετατρέψει ένα παλιό συμβάν μεταφοράς σε τρέχον ισχυρισμό.

Για παράδειγμα, ένα σύστημα μπορεί να διατηρεί ένα επαληθευμένο συμβάν «Παραδόθηκε» από προηγούμενη αναζήτηση, ενώ η τρέχουσα ανανέωση λήγει. Το συμβάν παράδοσης δεν εξαφανίζεται. Η σωστή συνδυασμένη κατάσταση είναι ότι η τελευταία διαθέσιμη κατάσταση αποστολής είναι «παραδόθηκε» και η πιο πρόσφατη ανανέωση απέτυχε. Αντίστροφα, αν το τελευταίο συμβάν είναι «Σε μεταφορά», η λήξη χρόνου δεν επιβεβαιώνει ότι το δέμα παραμένει σε μεταφορά αυτή τη στιγμή· επιβεβαιώνει μόνο ότι δεν λήφθηκε νεότερη απάντηση.

Εφαρμόστε καθορισμένο κανόνα όταν τα συμβάντα φτάνουν εκτός σειράς. Συγκρίνετε αναγνωριστικά συμβάντων, χρονικές σημάνσεις, πηγή και την τεκμηριωμένη σημασιολογία κατάστασης του παρόχου, όπου είναι διαθέσιμη. Μην υποθέτετε ότι η σειρά με την οποία το σύστημά σας έλαβε τις ενημερώσεις είναι η σειρά με την οποία συνέβησαν τα συμβάντα της αποστολής. Ούτε πρέπει ένα παλαιότερο συμβάν που έφτασε αργά να αντικαθιστά αυτόματα μια νεότερη επαληθευμένη κατάσταση. Διορθώσεις και εξαιρέσεις μπορεί ωστόσο να είναι νόμιμες, επομένως αποφύγετε έναν απόλυτο κανόνα που θεωρεί αδύνατες τις αλλαγές κατάστασης μετά την παράδοση. Διατηρήστε τα υποκείμενα συμβάντα και διερευνήστε τις αντιφάσεις αντί να ξαναγράφετε σιωπηρά το ιστορικό.

Αν ένας πάροχος επιστρέψει HTTP 202, ερμηνεύστε το σύμφωνα με τη σύμβαση του συγκεκριμένου endpoint: η αποδοχή ενός αιτήματος δεν σημαίνει από μόνη της ότι ολοκληρώθηκε η αναζήτηση παρακολούθησης. Ομοίως, το HTTP 200 επιβεβαιώνει ότι ένα αίτημα HTTP ολοκληρώθηκε επιτυχώς σύμφωνα με τη σημασιολογία του endpoint· δεν αποδεικνύει ότι κάθε πεδίο παρακολούθησης υπάρχει ή είναι τρέχον. Αντιστοιχίστε πεδία απόκρισης ειδικά για τον πάροχο μόνο αφού ελέγξετε την τεκμηρίωσή του.

Κάντε την αποτυχία ορατή στους χειριστές χωρίς να ανησυχείτε τους πελάτες

Μια χρήσιμη λειτουργική εγγραφή περιλαμβάνει το αναγνωριστικό αιτήματος, το endpoint ή τη λειτουργία, τον αριθμό προσπαθειών, τον χρόνο που παρήλθε, το επίπεδο λήξης χρόνου, την κατάσταση HTTP αν ελήφθη και το αν η απόκριση προήλθε από ζωντανή αναζήτηση ή εναλλακτική λύση. Για τα δεδομένα παρακολούθησης, καταγράψτε την πηγή και τις σχετικές χρονικές σημάνσεις συμβάντος ή ανάκτησης. Διαχειριστείτε τους αριθμούς παρακολούθησης και τις πληροφορίες πελατών σύμφωνα με τους κανόνες πρόσβασης και διατήρησης του οργανισμού σας· η διαγνωστική χρησιμότητα δεν αποτελεί λόγο έκθεσης πλήρων αναγνωριστικών σε μη περιορισμένα αρχεία καταγραφής.

Αναζητήστε μοτίβα αντί να βασίζεστε σε μία μόνο λήξη χρόνου. Η αύξηση του ποσοστού λήξεων σε μία διαδρομή μεταφορέα, οι επαναλαμβανόμενες αποκρίσεις 429 ή το διευρυνόμενο κενό μεταξύ της ώρας συμβάντος του μεταφορέα και της ώρας ανάκτησης μπορεί να υποδεικνύουν διαφορετικά προβλήματα. Το πρώτο μπορεί να απαιτεί διερεύνηση του παρόχου, το δεύτερο έλεγχο ρυθμού και το τρίτο έλεγχο συγχρονισμού ή παράδοσης συμβάντων. Αν μια εφαρμογή προσφέρει παρακολούθηση μέσω παρόχου όπως το 17TRACK Tracking API, χρησιμοποιήστε την τεκμηρίωση του παρόχου για να επαληθεύσετε τα ειδικά για το endpoint πεδία απόκρισης, τα όρια αιτημάτων και τον χειρισμό σφαλμάτων πριν εφαρμόσετε αυτούς τους γενικούς κανόνες.

Για το μήνυμα προς τον πελάτη, να είστε ακριβείς και συγκρατημένοι: «Δεν μπορέσαμε να ανανεώσουμε την παρακολούθηση αυτήν τη στιγμή. Ακολουθεί η τελευταία διαθέσιμη ενημέρωση». Δώστε επόμενο βήμα όταν βοηθά, όπως να ελέγξει ξανά αργότερα ή να επικοινωνήσει με την υποστήριξη αν η αποστολή υπερβαίνει το αναμενόμενο χρονικό διάστημα παράδοσης που παρέχεται από τον πωλητή ή τον μεταφορέα. Αποφύγετε να υποσχεθείτε χρόνο ανανέωσης που το σύστημά σας δεν μπορεί να εγγυηθεί.

Λίστα ελέγχου κυκλοφορίας για ροή παρακολούθησης ασφαλή από λήξεις χρόνου

  • Επιβεβαιώστε ποιο επίπεδο επιβάλλει κάθε λήξη χρόνου και ποιο επίπεδο διαχειρίζεται τις επαναλήψεις.
  • Ορίστε συνολική προθεσμία αιτήματος και ξεχωριστό, περιορισμένο προϋπολογισμό επαναλήψεων.
  • Επαληθεύστε ότι οι λειτουργίες που επαναλαμβάνονται αυτόματα είναι ασφαλείς για επανάληψη.
  • Τηρήστε τα όρια ρυθμού και τις έγκυρες οδηγίες Retry-After.
  • Αποθηκεύστε ξεχωριστά το αποτέλεσμα του αιτήματος από την κατάσταση αποστολής και το ιστορικό συμβάντων.
  • Επισημάνετε τα εναλλακτικά δεδομένα και διατηρήστε την πηγή και τις χρονικές σημάνσεις τους, όταν είναι διαθέσιμες.
  • Δοκιμάστε σενάρια χωρίς cache, με παλιά cache, 429, 503, 504 και καθυστερημένης απόκρισης.
  • Ελέγξτε ότι μια λήξη χρόνου δεν μπορεί να ενεργοποιήσει εσφαλμένη ειδοποίηση παράδοσης ή να διαγράψει επαληθευμένο συμβάν.

Ο βασικός κανόνας είναι απλός: επαναλαμβάνετε ένα αίτημα μόνο όταν αυτό είναι ασφαλές και χρήσιμο· χρησιμοποιείτε εναλλακτική λύση μόνο για πληροφορίες που μπορείτε να ταυτοποιήσετε· και ποτέ μην διατυπώνετε ισχυρισμό για την κατάσταση αποστολής από μια λήξη χρόνου HTTP.

Συχνές ερωτήσεις

Πρέπει να επαναλάβω αμέσως ένα αίτημα παρακολούθησης που έληξε;

Όχι αυτόματα. Ελέγξτε ότι η λειτουργία είναι ασφαλές να επαναληφθεί, ότι η συνολική προθεσμία αφήνει χρόνο για άλλη προσπάθεια και ότι καμία οδηγία περιορισμού ρυθμού δεν απαιτεί αναμονή. Μια σύντομη, περιορισμένη επανάληψη με τυχαιότητα μπορεί να είναι κατάλληλη για αναζήτηση μόνο για ανάγνωση· οι επαναλαμβανόμενες άμεσες προσπάθειες δεν αποτελούν καλή προεπιλογή.

Σημαίνει το HTTP 504 ότι το σύστημα παρακολούθησης του μεταφορέα είναι εκτός λειτουργίας;

Όχι. Σημαίνει ότι μια πύλη ή ένας διακομιστής μεσολάβησης δεν έλαβε έγκαιρη ανάντη απάντηση. Το πρόβλημα μπορεί να βρίσκεται οπουδήποτε κατά μήκος αυτής της διαδρομής αιτήματος. Δεν αποδεικνύει τη συνολική διαθεσιμότητα του μεταφορέα ή την κατάσταση του δέματος.

Μπορώ να εμφανίσω την τελευταία γνωστή κατάσταση μετά από λήξη χρόνου;

Ναι, αν την επισημάνετε ως την τελευταία διαθέσιμη πληροφορία και όχι ως επιτυχή ζωντανή ανανέωση. Εμφανίστε την ώρα συμβάντος και την ώρα ανάκτησης όταν είναι γνωστές και καταστήστε σαφές ότι δεν ήταν δυνατή η επιβεβαίωση νεότερης ενημέρωσης.

Πρέπει μια λήξη χρόνου να αλλάξει την αποστολή από «σε μεταφορά» σε «εξαίρεση»;

Όχι. Η λήξη χρόνου είναι αποτυχία αιτήματος και όχι συμβάν αποστολής. Αλλάξτε την κατάσταση αποστολής μόνο όταν μια αξιόπιστη πηγή παρακολούθησης παρέχει συμβάν ή κατάσταση που υποστηρίζει την αλλαγή.

Τι γίνεται αν το αίτημα που έληξε δημιουργούσε ή καταχωρίζε ένα αρχείο παρακολούθησης;

Μην υποθέσετε ότι απέτυχε. Το απομακρυσμένο σύστημα μπορεί να το επεξεργάστηκε πριν χαθεί η απόκριση. Ελέγξτε για υπάρχον αποτέλεσμα και χρησιμοποιήστε τεκμηριωμένο μηχανισμό idempotency ή διαδικασία ανάκτησης εγκεκριμένη από τον πάροχο πριν το υποβάλετε ξανά.

Πηγές