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

Αυτός ο οδηγός απευθύνεται σε προγραμματιστές και ομάδες λειτουργίας ηλεκτρονικού εμπορίου που δημιουργούν αυτή τη ροή εργασίας. Ο στόχος δεν είναι να προωθείται κάθε σάρωση του μεταφορέα. Είναι να ενημερώνονται οι πελάτες όταν αλλάζει κάτι ουσιαστικό, τι σημαίνει αυτή η αλλαγή και αν χρειάζεται να προβούν σε κάποια ενέργεια.
Σχεδιάστε τη ροή ειδοποιήσεων πριν συνδέσετε το API
Ένα API παρακολούθησης αποστολών παρέχει πληροφορίες παρακολούθησης· η εφαρμογή σας αποφασίζει πώς θα τις χρησιμοποιήσει. Αντιμετωπίστε την ορατότητα της αποστολής και την επικοινωνία με τον πελάτη ως ξεχωριστές αρμοδιότητες, ακόμη και αν η υπηρεσία που επιλέξατε προσφέρει και τις δύο.
Μια πρακτική αρχιτεκτονική έχει έξι στάδια:
- Σύνδεση παραγγελίας: συνδέστε έναν αριθμό παρακολούθησης και ένα αναγνωριστικό μεταφορέα, όπου απαιτείται, με μια εσωτερική εγγραφή αποστολής.
- Καταχώριση παρακολούθησης: υποβάλετε ή καταχωρίστε την αποστολή σύμφωνα με τις απαιτήσεις ενσωμάτωσης του παρόχου.
- Εισαγωγή ενημερώσεων: λάβετε επανακλήσεις webhook, ανακτήστε ενημερώσεις μέσω αιτημάτων API ή συνδυάστε και τις δύο προσεγγίσεις.
- Επεξεργασία γεγονότων: επικυρώστε, κανονικοποιήστε, εξαλείψτε τις διπλοεγγραφές και αξιολογήστε τα εισερχόμενα γεγονότα.
- Απόφαση ειδοποίησης: επιλέξτε αν θα σταλεί ειδοποίηση, ποιον θα ενημερώσετε και ποιο κανάλι και πρότυπο θα χρησιμοποιήσετε.
- Παράδοση μηνύματος: στείλτε την ειδοποίηση και καταγράψτε την απόκριση της υπηρεσίας μηνυμάτων.
Διατηρείτε τα στοιχεία επικοινωνίας των πελατών στο δικό σας σύστημα παραγγελιών ή μηνυμάτων, εκτός αν η ενσωμάτωση απαιτεί πραγματικά την κοινοποίησή τους. Μια υπηρεσία παρακολούθησης γενικά δεν χρειάζεται τη διεύθυνση email του πελάτη απλώς και μόνο για να συνδέσει η εφαρμογή σας ένα γεγονός παρακολούθησης με μια παραγγελία.
1. Επιβεβαιώστε τη σύμβαση ενσωμάτωσης
Πριν γράψετε τον δέκτη, ελέγξτε στην τεκμηρίωση του παρόχου τον έλεγχο ταυτότητας, την καταχώριση αποστολών, την αναγνώριση μεταφορέων, τις υποστηριζόμενες μεθόδους ενημέρωσης, τις μορφές αποκρίσεων, τα όρια αιτημάτων και τον χειρισμό σφαλμάτων. Για ενσωματώσεις webhook, ελέγξτε επίσης τον τρόπο ελέγχου ταυτότητας των επανακλήσεων, ποια απόκριση επιβεβαιώνει τη λήψη και πώς αντιμετωπίζονται οι ανεπιτυχείς παραδόσεις.
Για μια υλοποίηση 17TRACK, ξεκινήστε από τη σελίδα Tracking API της 17TRACK και την επίσημη τεκμηρίωση API. Χρησιμοποιήστε την τεκμηριωμένη σύμβαση για την ενσωμάτωσή σας αντί να θεωρείτε τα ενδεικτικά ονόματα πεδίων αυτού του οδηγού ως πεδία αιτήματος ή απόκρισης της 17TRACK. Επιβεβαιώστε τη ρύθμιση των επανακλήσεων, τις απαιτήσεις ασφαλείας και τα όρια του λογαριασμού πριν από την υλοποίηση.
Επιλέξτε τη μέθοδο ενημέρωσης σύμφωνα με τη σύμβαση ενσωμάτωσης:
- Webhooks: χρησιμοποιήστε επανακλήσεις όταν υποστηρίζονται και είναι κατάλληλες για την υποδομή σας. Επιτρέπουν στην εφαρμογή σας να επεξεργάζεται ενημερώσεις όταν τις στέλνει ο πάροχος, χωρίς να ζητά επανειλημμένα την ίδια αποστολή.
- Polling: ανακτάτε πληροφορίες παρακολούθησης βάσει προγράμματος όταν οι επανακλήσεις δεν είναι διαθέσιμες ή κατάλληλες. Διατηρείτε το πρόγραμμα εντός των τεκμηριωμένων ορίων αιτημάτων.
- Συνδυασμένη προσέγγιση: χρησιμοποιήστε επανακλήσεις για την κανονική επεξεργασία και επιλεκτική ανάκτηση μέσω API για να συμφιλιώνετε αποστολές των οποίων οι ενημερώσεις φαίνονται παρωχημένες, εφόσον ο πάροχος υποστηρίζει αυτή τη ροή εργασίας.
Μην υπόσχεστε στους πελάτες άμεσες ειδοποιήσεις απλώς επειδή χρησιμοποιείτε webhooks. Η εφαρμογή σας δεν μπορεί να αναφέρει ένα γεγονός του μεταφορέα πριν τα δεδομένα παρακολούθησης από την upstream πηγή το καταστήσουν διαθέσιμο.
2. Δημιουργήστε μια εγγραφή αποστολής που αντέχει σε πραγματικές παραγγελίες
Χρησιμοποιήστε ένα εσωτερικό αναγνωριστικό αποστολής ως κύρια αναφορά, όχι μόνο τον αριθμό παρακολούθησης. Μια παραγγελία μπορεί να περιέχει αρκετά πακέτα και δεν πρέπει να θεωρείτε ότι οι αριθμοί παρακολούθησης είναι παγκοσμίως μοναδικοί για πάντα.
Μια χρήσιμη εσωτερική εγγραφή περιλαμβάνει:
- Εσωτερικό αναγνωριστικό παραγγελίας και αποστολής.
- Αριθμό παρακολούθησης και αναγνωριστικό μεταφορέα, όταν είναι γνωστά.
- Την αναφορά αποστολής του παρόχου, εφόσον παρέχεται.
- Την τρέχουσα κανονικοποιημένη κατάσταση και το πιο πρόσφατο ουσιαστικό γεγονός.
- Τον χρόνο του γεγονότος από τον μεταφορέα, μαζί με τη ζώνη ώρας ή τη μετατόπισή του, όταν είναι διαθέσιμη.
- Τον χρόνο κατά τον οποίο το σύστημά σας έλαβε την ενημέρωση.
- Μια αναφορά στις προτιμήσεις επικοινωνίας του πελάτη.
- Το ιστορικό ειδοποιήσεων και οποιαδήποτε ενεργή ροή εργασίας εξαίρεσης.
Αποθηκεύετε ξεχωριστά τον χρόνο του γεγονότος από τον χρόνο λήψης. Μια σάρωση που πραγματοποιήθηκε νωρίτερα μπορεί να φτάσει μετά από μια νεότερη σάρωση. Αν η εφαρμογή σας ταξινομεί μόνο με βάση τη σειρά άφιξης, μπορεί εσφαλμένα να αλλάξει μια παραδοθείσα αποστολή σε «σε μεταφορά».
Για τμηματικές παραγγελίες, συνδέετε τις ειδοποιήσεις με το επηρεαζόμενο πακέτο. Το «Ένα πακέτο από την παραγγελία σας έφτασε» είναι ακριβέστερο από το «Η παραγγελία σας έφτασε» όταν ένα άλλο πακέτο βρίσκεται ακόμη σε μεταφορά.
3. Αντιστοιχίστε τα γεγονότα παρακολούθησης με τις αποφάσεις των πελατών
Οι περιγραφές των μεταφορέων είναι λειτουργικά δεδομένα και όχι έτοιμα μηνύματα προς πελάτες. Δημιουργήστε ένα επίπεδο κανονικοποίησης που διατηρεί το αρχικό γεγονός, ενώ του αναθέτει μια εσωτερική κατηγορία που μπορούν να κατανοήσουν οι κανόνες ειδοποιήσεων.
Οι ακόλουθες κατηγορίες είναι προτεινόμενες έννοιες εφαρμογής και όχι ένα καθολικό λεξιλόγιο καταστάσεων API:
| Εσωτερική κατηγορία | Απόφαση ειδοποίησης | Όριο επικοινωνίας |
|---|---|---|
| Λήψη πληροφοριών αποστολής | Στείλτε ενημέρωση προετοιμασίας μόνο αν είναι χρήσιμη. | Μην υπονοείτε κατοχή από τον μεταφορέα μόνο από τη δημιουργία ετικέτας. |
| Σε μεταφορά | Εξετάστε το ενδεχόμενο ειδοποίησης κατά την πρώτη ουσιαστική μετακίνηση. | Καταστείλετε τις συνηθισμένες σαρώσεις εγκαταστάσεων, εκτός αν αλλάζουν το επόμενο βήμα του πελάτη. |
| Προς παράδοση | Ειδοποιήστε όταν ένα υποστηριζόμενο γεγονός υποδεικνύει αυτή την κατάσταση. | Μην μετατρέπετε την κατάσταση σε εγγυημένη ώρα άφιξης. |
| Απόπειρα παράδοσης ή απαιτείται παραλαβή | Στείλτε ειδοποίηση που απαιτεί ενέργεια. | Συμπεριλάβετε προθεσμίες ή οδηγίες παραλαβής μόνο όταν έχουν επαληθευτεί. |
| Εξαίρεση παράδοσης | Αξιολογήστε την αιτία και αν ο πελάτης πρέπει να ενεργήσει. | Μην περιγράφετε κάθε εξαίρεση ως χαμένο δέμα. |
| Παραδόθηκε | Στείλτε επιβεβαίωση σε επίπεδο πακέτου. | Μην επινοείτε παραλήπτη, τοποθεσία παράδοσης ή αποδεικτικό παράδοσης. |
Διατηρείτε την αβεβαιότητα. Ένα μη αναγνωρισμένο γεγονός πρέπει να εισέρχεται σε διαδρομή ελέγχου ή εφεδρική διαδρομή αντί να εξαναγκάζεται στην πλησιέστερη γνωστή κατηγορία. Διατηρείτε την αρχική περιγραφή διαθέσιμη στο προσωπικό υποστήριξης για αντιμετώπιση προβλημάτων.
4. Λάβετε ενημερώσεις χωρίς απώλεια ή διπλή επεξεργασία
Το endpoint webhook σας πρέπει να επικυρώνει το αίτημα, να αποθηκεύει με ανθεκτικό τρόπο την αποδεκτή ενημέρωση και να επιστρέφει την επιβεβαίωση που απαιτεί ο πάροχος. Εκτελείτε τη δημιουργία μηνυμάτων ασύγχρονα αντί να περιμένετε μια υπηρεσία email ή SMS κατά τη διάρκεια του αιτήματος επανάκλησης.
Υλοποιήστε τη μέθοδο επαλήθευσης επανακλήσεων που τεκμηριώνει ο πάροχος. Μην επινοείτε κεφαλίδα υπογραφής και μην υποθέτετε ότι κάθε πάροχος χρησιμοποιεί το ίδιο σχήμα ελέγχου ταυτότητας. Εφαρμόστε επίσης HTTPS, όρια μεγέθους αιτημάτων, επικύρωση payload και κατάλληλους ελέγχους πρόσβασης.
Μια απλοποιημένη ροή επεξεργασίας είναι η εξής. Πρόκειται για λειτουργίες σε επίπεδο εφαρμογής και όχι για λειτουργικό παράδειγμα SDK:
receive callback
verify request using documented provider mechanism
validate payload
persist accepted payload and enqueue processing atomically
return documented acknowledgment
process queued update
find internal shipment
normalize relevant events
ignore already-processed events
evaluate chronology and state transition
create notification job if policy permits
commit state and job together
send notification job
check recipient preferences and suppression rules
submit message to messaging service
record result and retry only when appropriateΤα ατομικά βήματα είναι σημαντικά. Αν η εφαρμογή σας αποθηκεύσει μια αλλαγή κατάστασης αλλά καταρρεύσει πριν δημιουργήσει την εργασία ειδοποίησης, ο πελάτης μπορεί να μην λάβει ποτέ την ειδοποίηση. Το transactional outbox είναι μία επιλογή σχεδιασμού: αποθηκεύστε την αλλαγή κατάστασης και την εκκρεμή εργασία στην ίδια συναλλαγή βάσης δεδομένων και, στη συνέχεια, αφήστε έναν worker να αποστείλει την εργασία.
Χειριστείτε ρητά τις άγνωστες αναφορές αποστολών. Απομονώστε τις για διερεύνηση ή συμφιλίωση αντί να μαντεύετε ποιος πελάτης πρέπει να λάβει ειδοποίηση.
5. Προσθέστε προστασία από διπλότυπα και χρονολογικούς ελέγχους
Σχεδιάστε τον δέκτη ώστε να αντέχει επαναλαμβανόμενες επανακλήσεις και επαναλήψεις workers. Προτιμήστε ένα σταθερό αναγνωριστικό γεγονότος του παρόχου, όταν τεκμηριώνεται. Διαφορετικά, δημιουργήστε ένα deterministic αποτύπωμα γεγονότος από κατάλληλα πεδία, όπως το εσωτερικό αναγνωριστικό αποστολής, τον κωδικό γεγονότος, τον χρόνο του γεγονότος και την τοποθεσία. Δοκιμάστε αυτό το αποτύπωμα σε πραγματικά payload πριν βασιστείτε σε αυτό.
Η εξάλειψη διπλοτύπων γεγονότων και η καταστολή ειδοποιήσεων επιλύουν διαφορετικά προβλήματα. Η εξάλειψη διπλοτύπων εμποδίζει την επεξεργασία του ίδιου γεγονότος δύο φορές. Η καταστολή αποτρέπει τη δημιουργία ουσιαστικά του ίδιου μηνύματος προς τον πελάτη από αρκετές διαφορετικές σαρώσεις.
Ορίστε μια ταυτότητα ειδοποίησης γύρω από το επιχειρηματικό γεγονός. Μια επιβεβαίωση παράδοσης μπορεί να χρησιμοποιεί το αναγνωριστικό αποστολής και το ορόσημο «παραδόθηκε». Μια απόπειρα παράδοσης μπορεί να χρειάζεται ταυτότητα ειδική για την απόπειρα, επειδή μια μεταγενέστερη απόπειρα μπορεί να αποτελεί πραγματικά νέο γεγονός.
Για ενημερώσεις εκτός σειράς, συγκρίνετε τις χρονικές σημάνσεις των γεγονότων και αξιολογήστε τις επιτρεπόμενες μεταβάσεις κατάστασης. Μην υποθέτετε ότι μια επανάκληση περιέχει μόνο μια νέα σάρωση· ελέγξτε αν η τεκμηριωμένη δομή της αντιπροσωπεύει μεμονωμένο γεγονός, στιγμιότυπο ή ιστορικό. Δρομολογήστε τις αντιφατικές ενημερώσεις για συμφιλίωση αντί να απορρίπτετε σιωπηρά όλες τις διορθώσεις.
6. Γράψτε μηνύματα που εξηγούν τι ακολουθεί
Κάθε ειδοποίηση πρέπει να αναφέρει το σχετικό πακέτο, την επιβεβαιωμένη αλλαγή και το επόμενο βήμα του πελάτη. Συμπεριλάβετε ασφαλή σύνδεσμο παρακολούθησης και αναγνωρίσιμη αναφορά παραγγελίας. Αποφεύγετε την έκθεση πλήρων διευθύνσεων ή περιττών προσωπικών πληροφοριών σε μηνύματα SMS και προεπισκοπήσεις οθόνης κλειδώματος.
Για παράδειγμα:
- Προς παράδοση: «Το πακέτο σας για την παραγγελία {order_reference} είναι προς παράδοση. Παρακολουθήστε την πορεία του εδώ: {tracking_link}.»
- Έγινε απόπειρα παράδοσης: «Ο μεταφορέας ανέφερε απόπειρα παράδοσης για το πακέτο σας. Ελέγξτε τη σελίδα παρακολούθησης για τα διαθέσιμα επόμενα βήματα: {tracking_link}.»
- Παραδόθηκε: «Ο μεταφορέας σημείωσε το πακέτο σας για την παραγγελία {order_reference} ως παραδοθέν. Δείτε τις διαθέσιμες λεπτομέρειες παράδοσης: {tracking_link}.»
Αποδίδετε τα placeholders μόνο από επικυρωμένα δεδομένα. Αν υπάρχει διαθέσιμη και κατάλληλη εκτίμηση παράδοσης για εμφάνιση, επισημάνετέ την ως εκτίμηση. Αν λείπει, παραλείψτε την αντί να επινοήσετε ημερομηνία.
Για τις εξαιρέσεις, διακρίνετε ένα πρόβλημα αποστολής από μια εργασία του πελάτη. Μια διακοπή μπορεί να απαιτεί μόνο εξήγηση· ένα επαληθευμένο πρόβλημα διεύθυνσης μπορεί να απαιτεί ενέργεια. Μην στέλνετε πελάτες σε σελίδα πληρωμής ή μεταφόρτωσης εγγράφων αποκλειστικά με βάση μη αξιόπιστο περιεχόμενο παρακολούθησης ελεύθερου κειμένου.
Επιλέξτε κανάλια με βάση τις προτιμήσεις του πελάτη, τις άδειες καναλιών, την επείγουσα φύση και τους ισχύοντες κανόνες. Εξετάστε τις απαιτήσεις συναίνεσης, εξαίρεσης και ωρών ησυχίας για τις δικαιοδοσίες και τα κανάλια μηνυμάτων που χρησιμοποιείτε. Διατηρείτε τις ειδοποιήσεις υπηρεσίας παράδοσης ξεχωριστές από τις προωθητικές καμπάνιες αντί να υποθέτετε ότι οι ίδιες άδειες καλύπτουν και τις δύο.
7. Καθορίστε τι συμβαίνει όταν η παρακολούθηση σταματά
Η προληπτική επικοινωνία πρέπει να καλύπτει την έλλειψη προόδου καθώς και τα νέα γεγονότα, όμως η σιωπή από μόνη της δεν αποδεικνύει ότι μια αποστολή έχει καθυστερήσει ή χαθεί.
Δημιουργήστε κανόνα παρωχημένης παρακολούθησης χρησιμοποιώντας το επίπεδο υπηρεσίας, τη διαδρομή, το τελευταίο ουσιαστικό γεγονός και οποιαδήποτε υποστηριζόμενη εκτίμηση παράδοσης. Ορίστε τα κατώφλια από τα λειτουργικά δεδομένα και τη διαδικασία υποστήριξής σας, αντί να εφαρμόζετε μία καθολική περίοδο αναμονής σε κάθε αποστολή.
Όταν ενεργοποιείται αυτός ο κανόνας, ελέγξτε για χαμένη επεξεργασία, συμφιλιώστε τα δεδομένα με την πηγή παρακολούθησης όπου υποστηρίζεται και αποφασίστε αν θα ανοίξετε εσωτερική εργασία υποστήριξης. Αν ειδοποιήσετε τον πελάτη, χρησιμοποιήστε διατύπωση που αντανακλά όσα γνωρίζετε: «Δεν έχουμε λάβει νέα ενημέρωση παρακολούθησης» διαφέρει από το «Το πακέτο σας χάθηκε».
Αναθέστε υπεύθυνο για τις ανεπίλυτες εξαιρέσεις. Ένα σύστημα ειδοποιήσεων που ανακοινώνει επανειλημμένα ένα πρόβλημα χωρίς να δημιουργεί διαδρομή επίλυσης μπορεί να αυξήσει την απογοήτευση των πελατών.
8. Δοκιμάστε ολόκληρη τη διαδρομή πριν ενεργοποιήσετε τις αυτόματες αποστολές
Εκτελέστε πρώτα τη ροή εργασίας σε λειτουργία shadow: εισαγάγετε πραγματικά ή εγκεκριμένα δοκιμαστικά γεγονότα, δημιουργήστε προτεινόμενες ειδοποιήσεις και ελέγξτε τα αποτελέσματα χωρίς να επικοινωνήσετε με πελάτες.
- Επαναλάβετε μια πανομοιότυπη επανάκληση και επιβεβαιώστε ότι δεν δημιουργεί άλλο μήνυμα.
- Επεξεργαστείτε ένα παλαιότερο γεγονός μεταφοράς μετά από ένα γεγονός παράδοσης και ελέγξτε την τελική κατάσταση.
- Δοκιμάστε ελλείπουσες χρονικές σημάνσεις, άγνωστες καταστάσεις και κακοδιατυπωμένα payload.
- Προσομοιώστε αποτυχία βάσης δεδομένων πριν από την επιβεβαίωση και αποτυχία worker μετά την αποθήκευση.
- Δοκιμάστε χρονικά όρια μηνυμάτων, συμπεριλαμβανομένης μιας αβέβαιης απόκρισης στην οποία η υπηρεσία μπορεί ήδη να έχει αποδεχτεί το μήνυμα.
- Επιβεβαιώστε ότι οι τμηματικές αποστολές παράγουν διατύπωση ειδική για κάθε πακέτο.
- Ελέγξτε παραλήπτες που έχουν εξαιρεθεί, μη έγκυρα στοιχεία επικοινωνίας και τον χειρισμό ωρών ησυχίας.
- Επαληθεύστε ότι οι σύνδεσμοι παρακολούθησης δεν εκθέτουν πληροφορίες παραγγελίας άλλου πελάτη.
Παρακολουθείτε τις αποδεκτές επανακλήσεις, τις αποτυχίες επεξεργασίας, την ηλικία της ουράς, τις εργασίες ειδοποιήσεων, την καταστολή διπλοτύπων και τα αποτελέσματα μηνυμάτων. Μετράτε ξεχωριστά την καθυστέρηση επεξεργασίας από τον χρόνο λήψης του συστήματός σας και την ηλικία του γεγονότος του μεταφορέα. Αυτή η διάκριση βοηθά να εντοπιστεί αν μια αργή ειδοποίηση προήλθε από τη διαθεσιμότητα δεδομένων upstream ή από τη δική σας διοχέτευση.
Ξεκινήστε με ένα μικρό σύνολο σαφώς κατανοητών οροσήμων. Επεκτείνετε τους κανόνες μόνο αφού οι ομάδες υποστήριξης και λειτουργίας συμφωνήσουν ότι τα μηνύματα είναι ακριβή, χρήσιμα και αξίζει να λαμβάνονται.
Συχνές ερωτήσεις
Ένα API παρακολούθησης αποστολών στέλνει αυτόματα email ή SMS;
Όχι απαραίτητα. Η πρόσβαση σε δεδομένα παρακολούθησης και η ανταλλαγή μηνυμάτων με πελάτες είναι ξεχωριστές δυνατότητες. Ελέγξτε το τεκμηριωμένο πεδίο της υπηρεσίας. Σε μια προσαρμοσμένη ενσωμάτωση, η εφαρμογή σας μπορεί να επεξεργάζεται ενημερώσεις παρακολούθησης και να στέλνει ειδοποιήσεις μέσω ξεχωριστής υπηρεσίας μηνυμάτων.
Πρέπει να ειδοποιώ τους πελάτες για κάθε σάρωση παρακολούθησης;
Συνήθως όχι. Δώστε προτεραιότητα σε ουσιαστικά ορόσημα και γεγονότα που απαιτούν ενέργεια. Αρκετές σαρώσεις εγκαταστάσεων μπορεί να αντιπροσωπεύουν κανονική μεταφορά χωρίς να αλλάζουν όσα πρέπει να γνωρίζει ο πελάτης. Διατηρείτε το λεπτομερές ιστορικό στη σελίδα παρακολούθησης.
Μπορώ να εγγυηθώ ειδοποιήσεις παράδοσης σε πραγματικό χρόνο;
Μπορείτε να ορίσετε και να παρακολουθείτε έναν στόχο επεξεργασίας αφού το σύστημά σας λάβει μια ενημέρωση. Δεν μπορείτε να εγγυηθείτε πότε ένας μεταφορέας θα καταγράψει ή θα δημοσιεύσει μια σάρωση. Περιγράψτε την υπηρεσία με όρους που αντανακλούν αυτή την εξάρτηση.
Πώς μπορώ να αποτρέψω διπλά μηνύματα παράδοσης;
Χρησιμοποιήστε επίμονη εξάλειψη διπλοτύπων γεγονότων, ξεχωριστή ταυτότητα ειδοποίησης για κάθε επιχειρηματικό ορόσημο και συναλλακτική δημιουργία εργασιών. Όπου η υπηρεσία μηνυμάτων σας υποστηρίζει idempotency, χρησιμοποιήστε το ως πρόσθετη δικλείδα ασφαλείας. Ένας έλεγχος διπλοτύπων μόνο στη μνήμη δεν θα αντέξει σε επανεκκινήσεις ή σε πολλούς workers.
Τι πρέπει να συμβεί αν ο μεταφορέας διορθώσει μια κατάσταση «παραδόθηκε»;
Διατηρήστε και τα δύο γεγονότα και συμφιλιώστε την κατάσταση της αποστολής. Αν η διόρθωση επηρεάζει ουσιαστικά τον πελάτη, στείλτε σαφή διόρθωση ή δρομολογήστε την στην υποστήριξη σύμφωνα με την πολιτική σας. Μην καθιστάτε την κατάσταση «παραδόθηκε» μόνιμα μη αναστρέψιμη μόνο για να απλοποιήσετε τον κώδικα.
Πηγές
Οι ακόλουθοι επίσημοι πόροι αποτελούν τις αναφορές υλοποίησης για την ενσωμάτωση της 17TRACK που συζητείται παραπάνω. Το εσωτερικό σχήμα, οι κανόνες ειδοποιήσεων και η ροή επεξεργασίας αυτού του οδηγού είναι αρχιτεκτονικές προτάσεις και όχι παρατιθέμενες συμβάσεις API.
- 17TRACK Tracking API — επίσημο σημείο εκκίνησης για την αξιολόγηση της ενσωμάτωσης API.
- 17TRACK API documentation — αναφορά για τις ειδικές μορφές αιτημάτων του παρόχου, τον έλεγχο ταυτότητας, τις λειτουργίες παρακολούθησης και τις απαιτήσεις ενσωμάτωσης.


