Skip to main content
ΑρχικήΙστολόγιοΟδηγοίΠώς να στείλετε πολλούς αριθμούς παρακολούθησης σε ένα αίτημα API (Όρια παρτίδων και μερικές αποτυχίες)

Πώς να στείλετε πολλούς αριθμούς παρακολούθησης σε ένα αίτημα API (Όρια παρτίδων και μερικές αποτυχίες)

17TRACK

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

Πώς να στείλετε πολλούς αριθμούς παρακολούθησης σε ένα αίτημα API

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

Αρχικά, προσδιορίστε τι κάνει πραγματικά το endpoint παρτίδας

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

  • Καταχώριση: Υποβολή αποστολών ώστε η υπηρεσία να μπορεί να ξεκινήσει ή να συνεχίσει την παρακολούθησή τους.
  • Αναζήτηση: Αίτημα πληροφοριών παρακολούθησης για αποστολές, σύμφωνα με τους κανόνες ανάκτησης του endpoint.
  • Ενημέρωση παράδοσης: Λήψη μεταγενέστερων αλλαγών μέσω υποστηριζόμενου μηχανισμού, όπως webhooks, ή ανάκτησή τους μέσω προγραμματισμένων αιτημάτων.

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

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

Τα όρια παρτίδας είναι περισσότερα από έναν μέγιστο αριθμό αποστολών

Δεν υπάρχει καθολικό όριο παρτίδας για ένα Tracking API. Τα όρια μπορεί να διαφέρουν ανά πάροχο, endpoint, έκδοση API και διαμόρφωση λογαριασμού. Πριν εφαρμόσετε ομαδοποίηση σε παρτίδες, καταγράψτε ξεχωριστά αυτούς τους περιορισμούς.

ΠεριορισμόςΤι πρέπει να επιβεβαιώσετεΣυνέπεια υλοποίησης
Στοιχεία ανά αίτημαΜέγιστος αριθμός εγγραφών για τη συγκεκριμένη λειτουργίαΧωρίστε τη λίστα εισόδου πριν από την αποστολή
Μέγεθος σώματος αιτήματοςΤυχόν τεκμηριωμένο όριο byteΥπολογίστε τα προαιρετικά πεδία και το μέγεθος σειριοποίησης
Ρυθμός αιτημάτωνΕπιτρεπόμενα αιτήματα σε καθορισμένο χρονικό διάστημαΡυθμίστε τον ρυθμό μέσω κοινού περιοριστή
Ταυτόχρονη εκτέλεσηΤυχόν περιορισμός ταυτόχρονων αιτημάτωνΠεριορίστε τον αριθμό ενεργών workers
Καταμέτρηση χρήσηςΑν η χρήση υπολογίζεται ανά αίτημα, αποστολή ή άλλη μονάδαΕκτιμήστε την κατανάλωση ξεχωριστά από τον όγκο αιτημάτων

Για παράδειγμα, αν ένα υποθετικό endpoint επιτρέπει 25 εγγραφές ανά αίτημα, 63 εγγραφές απαιτούν τρία αιτήματα που περιέχουν 25, 25 και 13 εγγραφές. Αυτοί οι αριθμοί δείχνουν μόνο τον τεμαχισμό· δεν αποτελούν αναφερόμενα όρια του 17TRACK.

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

Προετοιμάστε τις εγγραφές πριν δημιουργήσετε το αίτημα

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

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

Για Carrier Tracking σε πολλά δίκτυα, μην συμπεραίνετε τον μεταφορέα αποκλειστικά από το μήκος ή το πρόθεμα ενός αριθμού παρακολούθησης, εκτός αν αυτό είναι αξιόπιστο για τη συγκεκριμένη ροή εργασίας σας. Όπου το API υποστηρίζει αναγνώριση μεταφορέα, ακολουθήστε τη documented συμπεριφορά του για την αντιμετώπιση αμφισημιών.

Ενδεικτική δομή αιτήματος

Το ακόλουθο JSON δείχνει την έννοια ενός payload παρτίδας. Το wrapper, τα ονόματα ιδιοτήτων και τα αναγνωριστικά είναι ενδεικτικά και δεν αποτελούν σχήμα αιτήματος 17TRACK. Ορισμένα API αναμένουν έναν array ανώτατου επιπέδου αντί για ένα αντικείμενο που περιέχει array.

{
  "shipments": [
    {
      "tracking_number": "EXAMPLE000001",
      "carrier_id": "DOCUMENTED_CARRIER_ID"
    },
    {
      "tracking_number": "EXAMPLE000002",
      "carrier_id": "DOCUMENTED_CARRIER_ID"
    }
  ]
}

Δημιουργήστε το payload μέσω σειριοποιητή JSON αντί να συνενώνετε συμβολοσειρές. Στείλτε τα διαπιστευτήρια ελέγχου ταυτότητας μέσω του τεκμηριωμένου μηχανισμού και κρατήστε τα εκτός του source control, του κώδικα που παραδίδεται στον browser και των συνηθισμένων αρχείων καταγραφής.

Επεξεργαστείτε την απόκριση σε δύο επίπεδα

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

Επίπεδο 1: Έλαβε το αίτημα χρησιμοποιήσιμη απόκριση;

Ξεκινήστε με την κατάσταση HTTP, τις κεφαλίδες της απόκρισης και το σώμα της. Σφάλματα ελέγχου ταυτότητας, κακοσχηματισμένα αιτήματα, περιορισμός ρυθμού και αστοχίες διακομιστή μπορεί να εμποδίσουν την κανονική επεξεργασία στοιχείων. Ένα timeout δικτύου είναι διαφορετικό: ο client μπορεί να μην γνωρίζει αν ο διακομιστής έλαβε ή επεξεργάστηκε το αίτημα.

Η σημασιολογία HTTP ορίζεται στο RFC 9110. Ωστόσο, η τεκμηρίωση του παρόχου καθορίζει τον τρόπο με τον οποίο τα πεδία αποτελέσματος σε επίπεδο εφαρμογής αντιστοιχούν στα πραγματικά αποτελέσματα αποστολής.

Επίπεδο 2: Τι συνέβη σε κάθε αποστολή;

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

  • Έγινε δεκτή: Η λειτουργία ολοκληρώθηκε επιτυχώς σύμφωνα με τον τεκμηριωμένο ορισμό του endpoint.
  • Μόνιμη αποτυχία εισόδου: Διορθώστε ή διερευνήστε την εγγραφή πριν από νέα προσπάθεια.
  • Επαναλήψιμη αποτυχία: Προγραμματίστε νέα προσπάθεια σύμφωνα με τις οδηγίες επανάληψης του παρόχου.
  • Άγνωστο αποτέλεσμα: Η απόκριση λείπει, είναι ελλιπής ή δεν μπορεί να αντιστοιχιστεί με ασφάλεια στην υποβληθείσα εγγραφή.

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

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

Αντιμετωπίστε τις μερικές αποτυχίες χωρίς επανάληψη των επιτυχών εγγραφών

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

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

ΑποτέλεσμαΠροτεινόμενη ενέργεια
Μη έγκυρο πεδίο ή μη υποστηριζόμενη τιμήΔιορθώστε τα δεδομένα εισόδου· μην επαναλάβετε χωρίς αλλαγές
Αποτυχία ελέγχου ταυτότητας ή δικαιωμάτωνΠαύστε την επηρεαζόμενη εργασία και διορθώστε τα διαπιστευτήρια ή την πρόσβαση
Απόκριση περιορισμού ρυθμούΚαθυστερήστε σύμφωνα με τις τεκμηριωμένες οδηγίες και τις σχετικές κεφαλίδες απόκρισης
Προσωρινό σφάλμα σε επίπεδο στοιχείουΕπαναλάβετε το στοιχείο με περιορισμένο αριθμό προσπαθειών και backoff
Timeout μετά την υποβολήΣημειώστε το ως αβέβαιο· συμφωνήστε το αποτέλεσμα ή χρησιμοποιήστε τεκμηριωμένες εγγυήσεις ασφάλειας επανάληψης
Μη αναγνωρισμένο ή ελλιπές αποτέλεσμαΔιατηρήστε τα στοιχεία και διερευνήστε αντί να υποθέσετε επιτυχία

Το HTTP 429 δηλώνει υπερβολικά πολλά αιτήματα και η απόκρισή του μπορεί να περιλαμβάνει κεφαλίδα Retry-After, όπως περιγράφεται στο RFC 6585. Μην θεωρείτε ότι αυτή η κεφαλίδα υπάρχει πάντα. Όταν δεν παρέχεται ρητή καθυστέρηση επανάληψης, χρησιμοποιήστε περιορισμένη πολιτική backoff συμβατή με την τεκμηρίωση του API.

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

Γιατί τα timeout χρειάζονται ειδική μεταχείριση

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

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

Μια πρακτική ροή επεξεργασίας παρτίδων

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

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

για κάθε παρτίδα μέσω pool workers με περιορισμένο μέγεθος:
    αποθήκευση εγγραφής προσπάθειας πριν από την αποστολή
    αναμονή στον κοινό περιοριστή ρυθμού
    αποστολή μέσω adapter ειδικού για τον πάροχο

    αν το αποτέλεσμα είναι αβέβαιο:
        τοποθέτηση σε ουρά συμφωνίας
        συνέχιση

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

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

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

Παρακολουθήστε τα αποτελέσματα αποστολών και όχι μόνο τη διαθεσιμότητα HTTP

Το API Monitoring πρέπει να δείχνει αν οι αποστολές φτάνουν στην επιθυμητή κατάσταση. Ένας πίνακας ελέγχου που αναφέρει μόνο ποσοστά επιτυχίας HTTP μπορεί να παραλείψει μερικές αποτυχίες μέσα σε κατά τα άλλα επιτυχείς αποκρίσεις.

  • Ποσοστό αποδοχής στοιχείων: Αποδεκτές εγγραφές διαιρεμένες με τις υποβληθείσες εγγραφές, με σαφώς καθορισμένη αντιμετώπιση των επαναλήψεων.
  • Κατανομή αποτυχιών: Πλήθος ανά endpoint, τεκμηριωμένο κωδικό σφάλματος και σχετικό πλαίσιο μεταφορέα.
  • Άγνωστα αποτελέσματα: Εγγραφές χωρίς συμφωνία και ο χρόνος για τον οποίο παραμένουν ανεπίλυτες.
  • Εκκρεμότητα επαναλήψεων: Εκκρεμείς επαναλήψεις, ηλικία παλαιότερης επανάληψης και εξαντλημένες προσπάθειες.
  • Υγεία αιτημάτων: Καθυστέρηση, timeout, περιορισμός ρυθμού και σφάλματα διακομιστή.
  • Επικαιρότητα παρακολούθησης: Αν οι αποδεκτές αποστολές λαμβάνουν στη συνέχεια χρήσιμες πληροφορίες παρακολούθησης.

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

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

Δοκιμάστε αυτές τις περιπτώσεις πριν από την παραγωγή

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

  1. Υποβάλετε μια έγκυρη παρτίδα στο τεκμηριωμένο όριο στοιχείων και στη συνέχεια δοκιμάστε πώς ο client σας αποτρέπει μια υπερμεγέθη παρτίδα.
  2. Επαληθεύστε ότι οι αριθμοί παρακολούθησης με αρχικά μηδενικά διατηρούνται κατά τη σειριοποίηση και την αποθήκευση.
  3. Δοκιμάστε συνδυασμό αποδεκτών και απορριφθέντων στοιχείων χωρίς επανάληψη των επιτυχών εγγραφών.
  4. Προσομοιώστε περιορισμό ρυθμού και επιβεβαιώστε ότι πολλοί workers τηρούν το ίδιο όριο.
  5. Προσομοιώστε timeout μετά την υποβολή και επαληθεύστε τη διαδρομή συμφωνίας.
  6. Επανεκκινήστε έναν worker μεταξύ της λήψης της απόκρισης και της τοπικής αποθήκευσης.
  7. Δοκιμάστε ελλιπή, άγνωστα ή μη αντιστοιχίσιμα αποτελέσματα στοιχείων.
  8. Επιβεβαιώστε ότι οι μη έγκυρες εγγραφές φτάνουν σε ορατή ουρά διόρθωσης αντί να επαναλαμβάνονται επ' αόριστον.

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

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

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

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

Μπορεί ένας μη έγκυρος αριθμός παρακολούθησης να προκαλέσει αποτυχία ολόκληρης της παρτίδας;

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

Πρέπει να επαναλάβω μια παρτίδα όταν η απόκριση HTTP είναι επιτυχής;

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

Μπορώ να συνδυάσω μεταφορείς στην ίδια παρτίδα;

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

Η ομαδοποίηση σε παρτίδες κάνει τις ενημερώσεις παρακολούθησης να φτάνουν γρηγορότερα;

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

Πηγές

  • 17TRACK Tracking API — επίσημο σημείο εισόδου προϊόντος για προγραμματιστές που αξιολογούν μια ενσωμάτωση παρακολούθησης.
  • 17TRACK API documentation — αναφορά για το ειδικό για τον πάροχο συμβόλαιο endpoint, τα όρια, τον έλεγχο ταυτότητας και τον χειρισμό αποκρίσεων.
  • RFC 9110: HTTP Semantics — σημασιολογία καταστάσεων HTTP, idempotency, αυτόματες επαναλήψεις και Retry-After.
  • RFC 6585: Additional HTTP Status Codes — ορισμός του HTTP 429 Too Many Requests και της προαιρετικής κεφαλίδας Retry-After.