Skip to main content
ΑρχικήΙστολόγιοΟδηγοίΠώς να λάβετε την πιο πρόσφατη κατάσταση αποστολής μέσω API χωρίς να περιμένετε webhook

Πώς να λάβετε την πιο πρόσφατη κατάσταση αποστολής μέσω API χωρίς να περιμένετε webhook

17TRACK

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

Πώς να λάβετε την πιο πρόσφατη κατάσταση αποστολής μέσω API χωρίς αναμονή

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

Αποφασίστε τι σημαίνει «πιο πρόσφατη κατάσταση αποστολής»

Πριν επιλέξετε ένα endpoint, διακρίνετε τρεις λειτουργίες που μπορεί να ακούγονται παρόμοιες αλλά παράγουν διαφορετικά αποτελέσματα.

ΛειτουργίαΤι κάνειΤι δεν επιβεβαιώνει
Ανάγνωση της δικής σας βάσης δεδομένωνΕπιστρέφει τις πληροφορίες παρακολούθησης που ήδη διαθέτει η εφαρμογή σας.Αν ο πάροχος έχει λάβει νεότερη ενημέρωση.
Ερώτημα στο API παρακολούθησηςΑνακτά τις πληροφορίες που είναι διαθέσιμες μέσω της λειτουργίας ερωτήματος του παρόχου.Αν πραγματοποιήθηκε νέος έλεγχος του μεταφορέα κατά τη διάρκεια του αιτήματος.
Αίτημα ανανέωσης παρακολούθησηςΖητά νέο έλεγχο από το ανώτερο σύστημα, εφόσον ο πάροχος προσφέρει αυτή τη λειτουργία.Ότι ο μεταφορέας έχει νέα σάρωση ή ότι η ανανέωση ολοκληρώνεται συγχρονισμένα.

Χρησιμοποιήστε ένα ερώτημα όταν χρειάζεστε απάντηση τώρα. Εξετάστε μια λειτουργία ανανέωσης μόνο όταν χρειάζεστε από τον πάροχο να επιχειρήσει νέο έλεγχο στο ανώτερο σύστημα. Μην υποθέτετε ότι η προσθήκη παραμέτρου αποφυγής cache, η επανάληψη ενός αιτήματος ή η αποστολή κεφαλίδας HTTP cache-control θα υποχρεώσει τον μεταφορέα να παρέχει νέες πληροφορίες.

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

Ελέγξτε τη σύμβαση του ερωτήματος πριν γράψετε κώδικα

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

  • Ταυτότητα αποστολής: Δέχεται το ερώτημα αριθμό παρακολούθησης, εσωτερικό ID αποστολής ή αριθμό παρακολούθησης σε συνδυασμό με αναγνωριστικό μεταφορέα;
  • Απαιτήσεις καταχώρισης: Πρέπει να καταχωριστεί η αποστολή πριν υποβληθεί ερώτημα;
  • Έλεγχος ταυτότητας: Ποια κεφαλίδα ή ποιος μηχανισμός ελέγχου ταυτότητας απαιτείται;
  • Σημασία απόκρισης: Η λειτουργία επιστρέφει αποθηκευμένες πληροφορίες, ξεκινά συλλογή δεδομένων ή επιστρέφει μια εργασία για μεταγενέστερο έλεγχο;
  • Διαχείριση αποτελέσματος: Μπορεί μια επιτυχής απόκριση HTTP να περιέχει αποτυχία σε επίπεδο αποστολής ή αποτέλεσμα σε εκκρεμότητα;
  • Περιορισμοί χρήσης: Ποια όρια ρυθμού, όρια παρτίδων και περιορισμοί ανά λογαριασμό ισχύουν;
  • Πεδία επικαιρότητας: Ποιες χρονικές σημάνσεις αντιπροσωπεύουν συμβάντα του μεταφορέα, ενημερώσεις του παρόχου και δημιουργία απόκρισης;

Για μια ενσωμάτωση του 17TRACK, το Tracking API είναι το σχετικό προϊόν και όχι μια σελίδα παρακολούθησης για καταναλωτές ή μια διεπαφή παρακολούθησης καταστήματος. Χρησιμοποιήστε την official API documentation για να επιβεβαιώσετε τη λειτουργία ερωτήματος πληροφοριών παρακολούθησης, τον έλεγχο ταυτότητας, τα πεδία αιτήματος και τη δομή απόκρισης για την ενσωμάτωσή σας. Αντιμετωπίστε τα ερωτήματα και τη διαχείριση webhook ως ξεχωριστές διαδρομές της εφαρμογής που ενημερώνουν την ίδια εγγραφή αποστολής.

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

Δημιουργήστε αναζήτηση κατ’ απαίτηση μέσω του backend σας

Ένας πρακτικός σχεδιασμός είναι να εκθέσετε ένα εξουσιοδοτημένο endpoint στη δική σας εφαρμογή. Το πρόγραμμα περιήγησης ζητά ενημέρωση αποστολής από αυτό το endpoint· ο διακομιστής σας ελέγχει την εξουσιοδότηση, αποφασίζει αν είναι απαραίτητο ερώτημα στον πάροχο και επιστρέφει ένα κανονικοποιημένο αποτέλεσμα.

Η ακόλουθη διαδρομή είναι παράδειγμα endpoint που θα δημιουργούσατε στην εφαρμογή σας. Δεν είναι endpoint του 17TRACK ούτε προδιαγραφή αιτήματος παρόχου.

GET /api/orders/{order_id}/shipment-status

Χρησιμοποιήστε το αναγνωριστικό παραγγελίας για να αναζητήσετε την αποστολή στον διακομιστή. Μην επιτρέπετε σε έναν καλούντα να ανακτήσει το ιστορικό παρακολούθησης άλλου πελάτη απλώς αντικαθιστώντας έναν αριθμό παρακολούθησης σε ένα αίτημα. Διατηρήστε τα διαπιστευτήρια API του παρόχου στο backend σας και όχι σε JavaScript του προγράμματος περιήγησης ή σε πακέτο εφαρμογής κινητού.

Μια ροή αιτήματος που μπορείτε να υλοποιήσετε

  1. Εξουσιοδότηση πρόσβασης. Επιβεβαιώστε ότι ο πελάτης ή το μέλος του προσωπικού επιτρέπεται να δει την παραγγελία.
  2. Εντοπισμός της αποστολής. Διαβάστε το αποθηκευμένο αναγνωριστικό παρακολούθησης και τις πληροφορίες μεταφορέα, όπου ισχύει.
  3. Έλεγχος τοπικής επικαιρότητας. Αν υπάρχει πρόσφατο επιτυχές ερώτημα, επαναχρησιμοποιήστε το σύμφωνα με την πολιτική επικαιρότητας της εφαρμογής σας.
  4. Ερώτημα στον πάροχο όταν χρειάζεται. Χρησιμοποιήστε την τεκμηριωμένη λειτουργία και ένα περιορισμένο χρονικό όριο αιτήματος.
  5. Επικύρωση του αποτελέσματος. Ελέγξτε τόσο την έκβαση HTTP όσο και το αποτέλεσμα σε επίπεδο αποστολής.
  6. Συγχώνευση των πληροφοριών. Εφαρμόστε τους ίδιους κανόνες κανονικοποίησης και συμφιλίωσης που χρησιμοποιούνται για τα συμβάντα webhook.
  7. Επιστροφή κατάστασης και επικαιρότητας. Συμπεριλάβετε τον χρόνο του πιο πρόσφατου συμβάντος και, όταν είναι διαθέσιμος, τον χρόνο του τελευταίου επιτυχούς ελέγχου στον πάροχο.

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

Κανονικοποιήστε την απόκριση χωρίς να επινοείτε επικαιρότητα

Η εφαρμογή σας μπορεί να επιστρέφει σταθερή εσωτερική μορφή ακόμη και όταν οι δομές αποκρίσεων των παρόχων διαφέρουν. Αυτό το ενδεικτικό αντικείμενο είναι η δική σας σύμβαση εφαρμογής και όχι πραγματικό payload παρόχου:

{
  "shipment_id": "internal-shipment-id",
  "status": "in_transit",
  "latest_event_at": null,
  "provider_updated_at": null,
  "last_successful_query_at": null,
  "retrieval_state": "success",
  "source": "provider_query"
}

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

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

Αποτρέψτε την αλληλοεπικάλυψη API και webhook

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

Μην χρησιμοποιείτε λογική «κερδίζει η τελευταία απόκριση». Το payload που λήφθηκε πιο πρόσφατα δεν είναι απαραίτητα η πιο πρόσφατη κατάσταση της αποστολής.

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

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

Χειριστείτε διαφορετικά τα ελλιπή δεδομένα και τα αποτυχημένα αιτήματα

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

Το ερώτημα ολοκληρώνεται επιτυχώς αλλά η κατάσταση δεν έχει αλλάξει

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

Η αποστολή δεν έχει ακόμη πληροφορίες παρακολούθησης

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

Το αίτημα προς τον πάροχο λήγει ή αποτυγχάνει

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

Χρησιμοποιήστε περιορισμένες επαναλήψεις με backoff και jitter για κατάλληλες παροδικές αποτυχίες. Μην επαναλαμβάνετε συνεχώς άκυρα διαπιστευτήρια ή κακοσχηματισμένα αιτήματα. Όταν μια απόκριση παρέχει Retry-After, ερμηνεύστε την σύμφωνα με τη σύμβαση του παρόχου και τη σημασιολογία HTTP. Η προδιαγραφή HTTP επιτρέπει η τιμή να εκφράζεται ως καθυστέρηση σε δευτερόλεπτα ή ως ημερομηνία HTTP.

Φτάνουν πολλά αιτήματα για την ίδια αποστολή

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

Χρησιμοποιήστε polling ως ελεγχόμενη εναλλακτική

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

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

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

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

Δοκιμάστε τη ροή εργασίας πριν από την κυκλοφορία

Ένα επιτυχές αίτημα είναι μόνο η πρώτη δοκιμή. Επαληθεύστε τις καταστάσεις που διαφορετικά μπορεί να δημιουργήσουν παραπλανητικές ενημερώσεις κατάστασης:

  • Ένα webhook φτάνει ενώ ένα ερώτημα κατ’ απαίτηση εκτελείται ακόμη.
  • Δύο πελάτες ή συνεδρίες προσωπικού ζητούν ταυτόχρονα την ίδια αποστολή.
  • Ο πάροχος επιστρέφει επιτυχία HTTP αλλά αναφέρει σφάλμα σε επίπεδο αποστολής.
  • Ένα αίτημα αποτυγχάνει αφού η εφαρμογή σας έχει ήδη έγκυρες πληροφορίες παρακολούθησης.
  • Ένα συμβάν δεν περιέχει ζώνη ώρας ή περιέχει άγνωστο κωδικό κατάστασης.
  • Μια διόρθωση του μεταφορέα αλλάζει ένα αποτέλεσμα που είχε εμφανιστεί προηγουμένως.
  • Ένας χρήστης προσπαθεί να αποκτήσει πρόσβαση σε αποστολή άλλου λογαριασμού.

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

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

Το ερώτημα στο API υποχρεώνει τον μεταφορέα να σαρώσει ή να ενημερώσει ένα δέμα;

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

Μπορώ να χρησιμοποιώ ερωτήματα API χωρίς να ρυθμίσω webhooks;

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

Πόσο συχνά πρέπει να ελέγχω την κατάσταση αποστολής με polling;

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

Γιατί το API επιστρέφει πληροφορίες που έλαβα ήδη μέσω webhook;

Και οι δύο διαδρομές μπορούν να εκθέτουν την ίδια υποκείμενη εγγραφή αποστολής. Ένα webhook παραδίδει ειδοποίηση, ενώ ένα ερώτημα ανακτά πληροφορίες κατ’ απαίτηση. Η λήψη του ίδιου συμβάντος και από τις δύο διαδρομές δεν αποτελεί απαραίτητα σφάλμα· η εφαρμογή σας πρέπει να το αποφεύγει ως διπλό.

Πρέπει το κουμπί ενημέρωσης να γράφει «Ανανέωση παρακολούθησης»;

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

Πηγές

  • 17TRACK Tracking API — επίσημη αναφορά προϊόντος για την ενσωμάτωση API παρακολούθησης που συζητείται σε αυτόν τον οδηγό.
  • 17TRACK API documentation — αναφορά για λειτουργίες ειδικές στον πάροχο, έλεγχο ταυτότητας, πεδία αιτήματος και διαχείριση αποκρίσεων.
  • RFC 9110, Section 10.2.3: Retry-After — ορίζει τις μορφές delay-seconds και HTTP-date της κεφαλίδας HTTP.