Σφάλμα ελέγχου ταυτότητας στο Tracking API: 7 αιτίες για απαντήσεις 401/403 και τρόποι επίλυσής τους
Ένα σφάλμα ελέγχου ταυτότητας σε ένα tracking API συνήθως οφείλεται σε μία από επτά αιτίες: απουσία διαπιστευτηρίου, εσφαλμένα διαμορφωμένη κεφαλίδα ελέγχου ταυτότητας, μη έγκυρο ή ανακληθέν μυστικό, ασυμφωνία περιβάλλοντος, ανεπαρκή δικαιώματα, ληγμένο token ή μη έγκυρη υπογραφή ή κανόνα ασφαλείας που αποκλείει το αίτημα. Για να διορθώσετε μια απόκριση 401 ή 403, εντοπίστε πρώτα ποιο σύστημα την επέστρεψε και, στη συνέχεια, ελέγξτε το αίτημα σε σχέση με τις απαιτήσεις ελέγχου ταυτότητας του παρόχου. Οι επαναλαμβανόμενες προσπάθειες με αμετάβλητα διαπιστευτήρια σπάνια επιλύουν το υποκείμενο πρόβλημα.

Αυτός ο οδηγός απευθύνεται σε προγραμματιστές και ομάδες ενσωμάτωσης που συνδέουν την παρακολούθηση αποστολών με μια πλατφόρμα ηλεκτρονικού εμπορίου, ένα σύστημα διαχείρισης παραγγελιών, μια εφαρμογή αποθήκης ή έναν εσωτερικό πίνακα ελέγχου. Ξεκινήστε με ένα αποτυχημένο αίτημα αντί να αλλάξετε τα διαπιστευτήρια σε ολόκληρη την ενσωμάτωση.
Πρώτα, διακρίνετε το 401 από το 403
Οι ορισμοί του HTTP αποτελούν αφετηρία και όχι πλήρη διάγνωση. Το 401 Unauthorized σημαίνει ότι από το αίτημα λείπουν έγκυρα διαπιστευτήρια ελέγχου ταυτότητας για τον πόρο-στόχο. Το 403 Forbidden σημαίνει ότι ο διακομιστής κατανόησε το αίτημα, αλλά αρνείται να το εξυπηρετήσει. Ένα 403 δεν αποδεικνύει απαραίτητα ότι ο έλεγχος ταυτότητας ολοκληρώθηκε με επιτυχία: μια πύλη ή υπηρεσία ασφαλείας μπορεί να απορρίψει ένα αίτημα πριν η εφαρμογή αξιολογήσει τα διαπιστευτήριά του.
Σύμφωνα με το RFC 9110, ένας διακομιστής που δημιουργεί απόκριση 401 πρέπει να περιλαμβάνει μια πρόκληση WWW-Authenticate. Ελέγξτε αυτήν την κεφαλίδα όταν υπάρχει, αλλά διαβάστε επίσης το σώμα της απόκρισης και την τεκμηρίωση σφαλμάτων του παρόχου. Οι υλοποιήσεις δεν εμφανίζουν πάντα τα σφάλματα με τον ίδιο τρόπο.
| Τι παρατηρείτε | Τι πρέπει να διερευνήσετε πρώτα |
|---|---|
| 401 με μήνυμα για διαπιστευτήριο που λείπει ή δεν είναι έγκυρο | Έγχυση διαπιστευτηρίων, μορφή κεφαλίδας και εγκυρότητα διαπιστευτηρίων |
| 403 με μήνυμα ανεπαρκών δικαιωμάτων | Περιοχές πρόσβασης, πρόσβαση λογαριασμού, tenant και ιδιοκτησία πόρου |
| 403 με σελίδα ασφαλείας HTML | Πύλη, διακομιστής μεσολάβησης, τείχος προστασίας ή πολιτική πρόσβασης |
| Επιτυχία HTTP με σφάλμα μέσα σε JSON | Τα πεδία σφάλματος σε επίπεδο εφαρμογής του παρόχου |
Καταγράφετε ξεχωριστά την κατάσταση μεταφοράς και την κατάσταση εφαρμογής. Ένα πεδίο JSON με όνομα code δεν είναι αυτομάτως κατάσταση HTTP και μια επιτυχής ανταλλαγή HTTP δεν σημαίνει απαραίτητα ότι η ζητούμενη λειτουργία παρακολούθησης ολοκληρώθηκε με επιτυχία.
Καταγράψτε ένα ασφαλές διαγνωστικό αρχείο
Πριν αλλάξετε οτιδήποτε, καταγράψτε τη χρονική σήμανση UTC, τη μέθοδο HTTP, το hostname, τη διαδρομή, την κατάσταση απόκρισης, το μήνυμα σφάλματος του παρόχου, το αναγνωριστικό αιτήματος και το περιβάλλον ανάπτυξης. Σημειώστε αν η απόκριση προήλθε από τον πάροχο παρακολούθησης, το δικό σας backend ή έναν ενδιάμεσο.
Καταγράψτε τα ονόματα των κεφαλίδων ελέγχου ταυτότητας και αν υπάρχουν τιμές, αλλά μην καταγράφετε ποτέ πλήρη API keys, bearer tokens, refresh tokens ή μυστικά υπογραφής. Αποφύγετε την εξαγωγή ιχνών αιτημάτων χωρίς απόκρυψη. Οι αριθμοί παρακολούθησης και οι λεπτομέρειες αποστολών ενδέχεται επίσης να απαιτούν απόκρυψη σύμφωνα με τους κανόνες διαχείρισης δεδομένων του οργανισμού σας.
Χρησιμοποιήστε μια λειτουργία χαμηλού αντίκτυπου που τεκμηριώνεται από τον πάροχο για να αναπαραγάγετε το πρόβλημα. Μην καταχωρίζετε επανειλημμένα αποστολές, μην δημιουργείτε συνδρομές και μην αλλάζετε ρυθμίσεις webhook μόνο για να δοκιμάσετε τον έλεγχο ταυτότητας.
7 αιτίες αποκρίσεων 401/403 στο tracking API
1. Το διαπιστευτήριο δεν φτάνει ποτέ στο API
Ένα μυστικό μπορεί να υπάρχει σε μια κονσόλα ανάπτυξης χωρίς να είναι διαθέσιμο στην εφαρμογή που εκτελείται. Συνήθη σημεία αποτυχίας περιλαμβάνουν μια μεταβλητή περιβάλλοντος που λείπει, μια εσφαλμένη αναφορά μυστικού, έναν worker που δεν επανεκκινήθηκε μετά από αλλαγή διαμόρφωσης ή ένα πρόγραμμα δημιουργίας αιτημάτων που παραλείπει κενές τιμές.
Ένας proxy μπορεί επίσης να αφαιρέσει μια κεφαλίδα ελέγχου ταυτότητας. Οι ανακατευθύνσεις χρειάζονται επίσης προσοχή, επειδή ένας client HTTP ενδέχεται να μην προωθεί ευαίσθητες κεφαλίδες σε διαφορετικό host.
- Έλεγχος: Επιθεωρήστε το αίτημα στο τελευταίο αξιόπιστο σημείο εξόδου. Επιβεβαιώστε ότι η απαιτούμενη κεφαλίδα υπάρχει και περιέχει μη κενή τιμή.
- Διόρθωση: Διορθώστε την αντιστοίχιση του μυστικού ή τη δημιουργία του αιτήματος και, αν απαιτείται, επαναφορτώστε την επηρεαζόμενη διεργασία.
- Επαλήθευση: Εκτελέστε την ίδια λειτουργία μέσω της εφαρμογής που έχει αναπτυχθεί και όχι μόνο από τον φορητό υπολογιστή ενός προγραμματιστή.
Αν τα τοπικά αιτήματα λειτουργούν αλλά οι εργασίες παρασκηνίου αποτυγχάνουν, συγκρίνετε πρώτα τη διαμόρφωση χρόνου εκτέλεσης. Η εφαρμογή και οι workers εργασιών μπορεί να λαμβάνουν μυστικά μέσω διαφορετικών μηχανισμών.
2. Η μορφή ελέγχου ταυτότητας είναι εσφαλμένη
Δεν δέχονται όλα τα tracking APIs το ίδιο σχήμα ελέγχου ταυτότητας. Ένας πάροχος μπορεί να απαιτεί ειδική κεφαλίδα API key, ένα OAuth bearer token ή ένα υπογεγραμμένο αίτημα. Η τοποθέτηση ενός έγκυρου key στο Authorization: Bearer δεν βοηθά αν το endpoint απαιτεί διαφορετική κεφαλίδα.
Άλλα σφάλματα περιλαμβάνουν την αντιγραφή εισαγωγικών σε ένα μυστικό, την προσθήκη προθέματος που δεν απαιτεί ο πάροχος, την αποστολή διπλότυπων κεφαλίδων ελέγχου ταυτότητας ή τη χρήση πεδίου διαμόρφωσης SDK που εφαρμόζεται σε διαφορετική μέθοδο ελέγχου ταυτότητας.
- Έλεγχος: Συγκρίνετε το πραγματικό αίτημα με το επίσημο παράδειγμα για το συγκεκριμένο endpoint και την έκδοση API.
- Διόρθωση: Ταιριάξτε το τεκμηριωμένο όνομα κεφαλίδας, τη μορφή τιμής και το σχήμα ελέγχου ταυτότητας. Μην μεταφέρετε ένα μυστικό στο URL ως λύση ανάγκης.
- Επαλήθευση: Συγκρίνετε ένα ελάχιστο αίτημα με το αίτημα που δημιουργεί το SDK, διατηρώντας τα διαπιστευτήρια κρυφά.
Τα ονόματα πεδίων των κεφαλίδων HTTP δεν διακρίνουν πεζά και κεφαλαία σύμφωνα με τη σημασιολογία HTTP. Επομένως, η αλλαγή μόνο της κεφαλαιοποίησης δεν αποτελεί συνήθη λύση. Εστιάστε στο σωστό πεδίο, τη σωστή τιμή και τη σωστή διαδρομή μετάδοσης.
3. Το key είναι εσφαλμένο, ανακληθέν ή δεν έχει αναπτυχθεί πλέον με συνέπεια
Ένα αντιγραμμένο key μπορεί να είναι ελλιπές, να ανήκει σε άλλο λογαριασμό ή να ανακλήθηκε κατά τη διάρκεια αλλαγής ασφαλείας. Η εναλλαγή διαπιστευτηρίων μπορεί επίσης να προκαλέσει διαλείπουσες αποτυχίες: ορισμένα instances της εφαρμογής χρησιμοποιούν το νέο μυστικό, ενώ άλλα συνεχίζουν να χρησιμοποιούν το παλιό.
Μην υποθέτετε ότι κάθε API key λήγει αυτόματα. Οι κανόνες λήξης και εναλλαγής εξαρτώνται από τον πάροχο και τον τύπο διαπιστευτηρίου.
- Έλεγχος: Επιβεβαιώστε την κατάσταση του διαπιστευτηρίου στην εξουσιοδοτημένη κονσόλα λογαριασμού και συγκρίνετε την αναπτυγμένη έκδοση του μυστικού σε εφαρμογές, workers και προγραμματισμένες εργασίες.
- Διόρθωση: Αναπτύξτε ένα έγκυρο διαπιστευτήριο μέσω της διαδικασίας διαχείρισης μυστικών. Αν υπάρχει υποψία έκθεσης, ακολουθήστε τη διαδικασία περιστατικών και ανακαλέστε το παραβιασμένο διαπιστευτήριο.
- Επαλήθευση: Ελέγξτε κάθε επηρεαζόμενη διαδρομή εκτέλεσης μετά την ανάπτυξη. Ένα μόνο επιτυχές αίτημα δεν αποδεικνύει ότι έχουν ενημερωθεί όλα τα instances.
Όπου υποστηρίζεται, χρησιμοποιήστε ένα μη μυστικό αναγνωριστικό διαπιστευτηρίου ή την έκδοση του secret manager για να διακρίνετε τις αναπτύξεις. Μην ζητάτε ποτέ από πελάτη ή συνάδελφο να επικολλήσει πλήρες key σε ticket υποστήριξης.
4. Το διαπιστευτήριο και το endpoint ανήκουν σε διαφορετικά περιβάλλοντα
Ορισμένες υπηρεσίες διαχωρίζουν διαπιστευτήρια παραγωγής και δοκιμών, περιφερειακά endpoints, λογαριασμούς ή tenants. Ένα έγκυρο διαπιστευτήριο μπορεί να αποτύχει όταν αποσταλεί σε λάθος host ή πλαίσιο λογαριασμού. Αυτός ο έλεγχος ισχύει μόνο όταν ο πάροχος τεκμηριώνει αυτές τις διακρίσεις.
Μια άλλη πιθανότητα είναι ένα παλιό base URL. Μια ενσωμάτωση μπορεί να χρησιμοποιεί παλιό endpoint, ενώ η διαμόρφωση ελέγχου ταυτότητας έχει ήδη ενημερωθεί για νεότερο API.
- Έλεγχος: Ελέγξτε ολόκληρο τον προορισμό: scheme, hostname, έκδοση API, path και τυχόν απαιτούμενο αναγνωριστικό λογαριασμού ή tenant.
- Διόρθωση: Συνδυάστε το διαπιστευτήριο με το προβλεπόμενο περιβάλλον και endpoint. Διατηρήστε μαζί τη διαμόρφωση URL και μυστικού κάθε περιβάλλοντος.
- Επαλήθευση: Επιβεβαιώστε τον προορισμό που επιλύεται στην ενεργή ανάπτυξη και ελέγξτε αν ο client ακολουθεί ανακατευθύνσεις.
Αποφύγετε τη δοκιμή λίστας εικαστικών hosts με πραγματικό διαπιστευτήριο. Χρησιμοποιείτε μόνο endpoints που τεκμηριώνει ο πάροχος.
5. Ο έλεγχος ταυτότητας επιτυγχάνει, αλλά τα δικαιώματα είναι ανεπαρκή
Ένα διαπιστευτήριο μπορεί να αναγνωρίζει τον καλούντα χωρίς να εξουσιοδοτεί τη ζητούμενη λειτουργία. Η ανάγνωση συμβάντων αποστολής, η καταχώριση αριθμών παρακολούθησης, η αλλαγή συνδρομών και η διαχείριση λογαριασμού μπορεί να απαιτούν διαφορετικά δικαιώματα πρόσβασης.
Σημαντική είναι και η ιδιοκτησία του πόρου. Μια αποστολή που είναι ορατή σε έναν χώρο εργασίας μπορεί να μην είναι προσβάσιμη μέσω διαπιστευτηρίου που συνδέεται με άλλον. Ορισμένα συστήματα περιορίζουν σκόπιμα τις λεπτομέρειες σφάλματος, επομένως ένα 403 από μόνο του δεν μπορεί να αποδείξει αν υπάρχει ένας πόρος.
- Έλεγχος: Επιθεωρήστε τα scopes, τους ρόλους, τη συμμετοχή στον λογαριασμό, την ιδιοκτησία πόρων και τις απαιτήσεις πρόσβασης του συγκεκριμένου endpoint.
- Διόρθωση: Παραχωρήστε μόνο το απαιτούμενο δικαίωμα για την ενσωμάτωση ή χρησιμοποιήστε τον σωστό εξουσιοδοτημένο λογαριασμό.
- Επαλήθευση: Δοκιμάστε την αποτυχημένη λειτουργία σε πόρο που ο λογαριασμός είναι γνωστό ότι ελέγχει.
Για OAuth bearer tokens, το RFC 6750 διακρίνει το invalid_token από το insufficient_scope. Όπου ο πάροχος ακολουθεί αυτήν τη σύμβαση, το πρώτο παραπέμπει στην εγκυρότητα του token, ενώ το δεύτερο στην εξουσιοδότηση. Μην υποθέτετε ότι κάθε tracking API χρησιμοποιεί OAuth ή αυτά τα πεδία σφάλματος.
6. Ένα token έχει λήξει ή η υπογραφή του αιτήματος δεν είναι έγκυρη
Ο έλεγχος ταυτότητας που εξαρτάται από τον χρόνο προσθέτει τρόπους αποτυχίας πέρα από ένα εσφαλμένο στατικό key. Ένα OAuth access token μπορεί να λήξει. Ένα υπογεγραμμένο αίτημα μπορεί να απορριφθεί επειδή η χρονική του σήμανση βρίσκεται εκτός του αποδεκτού παραθύρου ή επειδή ο διακομιστής υπολογίζει διαφορετική υπογραφή.
Ασυμφωνίες υπογραφής μπορεί να προκύψουν από την υπογραφή ενός σώματος αιτήματος και την αποστολή άλλου, τη διαφορετική κωδικοποίηση ενός path, την αλλαγή παραμέτρων query ή τη χρήση λάθος μυστικού υπογραφής. Αυτοί οι έλεγχοι ισχύουν μόνο για APIs που τεκμηριώνουν υπογεγραμμένα αιτήματα.
- Έλεγχος: Εξετάστε τη λήξη του token και τα αποτελέσματα ανανέωσης. Για υπογραφές, συγκρίνετε το τεκμηριωμένο canonical request με τα ακριβή bytes και πεδία που στάλθηκαν.
- Διόρθωση: Ανανεώστε ή αποκτήστε tokens μέσω της υποστηριζόμενης ροής, συγχρονίστε την ώρα του συστήματος και δημιουργήστε υπογραφές αφού οριστικοποιήσετε τα στοιχεία του υπογεγραμμένου αιτήματος.
- Επαλήθευση: Δοκιμάστε και μετά το επόμενο όριο ανανέωσης token και όχι μόνο αμέσως μετά την απόκτηση νέου token.
Σε συστήματα με πολλούς workers, συντονίστε τις ανανεώσεις token ώστε οι workers να μην αντικαθιστούν επανειλημμένα έγκυρα διαπιστευτήρια ή να προκαλούν ανταγωνιστικές προσπάθειες ανανέωσης. Διατηρείτε τα refresh tokens προστατευμένα και ξεχωριστά από τα συνηθισμένα logs αιτημάτων.
7. Μια πύλη, ένα τείχος προστασίας ή μια πολιτική δικτύου αποκλείει το αίτημα
Ένα 403 μπορεί να προέρχεται εκτός της εφαρμογής παρακολούθησης. Πιθανές αιτίες περιλαμβάνουν ασυμφωνία λίστας επιτρεπόμενων IP, πολιτική εξερχόμενου proxy, κανόνα web application firewall ή πύλη πρόσβασης που απαιτεί δικό της έλεγχο ταυτότητας.
Μια σελίδα άρνησης HTML, μια άγνωστη κεφαλίδα απόκρισης ή ένα αναγνωριστικό αιτήματος ειδικό για πύλη μπορεί να βοηθήσει στον εντοπισμό του επιπέδου που απορρίπτει το αίτημα. Αυτά είναι ενδείξεις και όχι αποδείξεις· επιβεβαιώστε τα με logs της πύλης ή με την ομάδα υποστήριξης του παρόχου.
- Έλεγχος: Συγκρίνετε τη δημόσια IP εξόδου και τη διαδρομή δικτύου της αποτυχημένης ανάπτυξης με ένα γνωστά λειτουργικό περιβάλλον.
- Διόρθωση: Διορθώστε τη σχετική λίστα επιτρεπόμενων, τη διαμόρφωση proxy ή τον στενά οριοθετημένο κανόνα ασφαλείας μέσω της αρμόδιας ομάδας υποδομής.
- Επαλήθευση: Επαναλάβετε το αίτημα από το αρχικό runtime μετά την αλλαγή της πολιτικής.
Μην απενεργοποιείτε την επαλήθευση πιστοποιητικών TLS και μην παρακάμπτετε ευρέως τους ελέγχους ασφαλείας. Οι αποτυχίες CORS στον browser χρειάζονται ξεχωριστή διάγνωση: ελέγξτε αν το απορριφθέν αίτημα είναι αίτημα preflight OPTIONS ή η πραγματική κλήση API. Τα μακρόβια secrets του tracking API δεν πρέπει να εκτίθενται σε κώδικα browser.
Χρησιμοποιήστε ένα ελάχιστο αίτημα για να απομονώσετε το σφάλμα
Μειώστε την αποτυχημένη κλήση στο τεκμηριωμένο endpoint, τη μέθοδο, τον απαιτούμενο έλεγχο ταυτότητας και το μικρότερο έγκυρο payload. Το παρακάτω είναι ένα γενικό πρότυπο διάγνωσης και όχι λειτουργικό αίτημα συγκεκριμένου παρόχου:
curl --include \
--request "$DOCUMENTED_METHOD" \
--url "$DOCUMENTED_ENDPOINT" \
--header "$DOCUMENTED_AUTH_HEADER: $DOCUMENTED_AUTH_VALUE"Προσθέστε τον απαιτούμενο τύπο περιεχομένου και το σώμα αν τα χρειάζεται η λειτουργία. Χρησιμοποιήστε το μόνο σε ελεγχόμενο περιβάλλον: τα ορίσματα εντολών, οι καταγραφές τερματικού και τα διαγνωστικά εργαλεία μπορεί να εκθέσουν μυστικά. Αποφύγετε λεπτομερή traces, εκτός αν μπορείτε να προστατεύσετε και να αποκρύψετε την έξοδό τους.
Αν το ελάχιστο αίτημα επιτυγχάνει αλλά η εφαρμογή αποτυγχάνει, ελέγξτε τη διαμόρφωση SDK, τη δημιουργία κεφαλίδων, τις ανακατευθύνσεις, τη συμπεριφορά proxy και τα secrets χρόνου εκτέλεσης. Αν αποτυγχάνουν και τα δύο, διερευνήστε την εγκυρότητα διαπιστευτηρίων, την επιλογή endpoint, τα δικαιώματα και την πολιτική δικτύου. Αλλάζετε μία μεταβλητή κάθε φορά ώστε το αποτέλεσμα να προσδιορίζει την αιτία.
Εφαρμογή των ελέγχων σε ενσωμάτωση 17TRACK
Για μια ενσωμάτωση 17TRACK Tracking API, ξεκινήστε από την επίσημη τεκμηρίωση API και αντιστοιχίστε τις οδηγίες ελέγχου ταυτότητας και τη μορφή αιτήματος για τη λειτουργία που καλείτε. Μην αντικαθιστάτε ένα μοτίβο ελέγχου ταυτότητας που αντιγράφηκε από άσχετο API και μην θεωρείτε ότι η πρόσβαση σε σελίδα παρακολούθησης για καταναλωτές επιβεβαιώνει την εξουσιοδότηση API.
Συγκρίνετε το τεκμηριωμένο αίτημα με το αίτημα που εξέρχεται από τον διακομιστή σας και, στη συνέχεια, ελέγξτε τόσο την απόκριση HTTP όσο και τα τεκμηριωμένα πεδία απόκρισης. Αν απαιτείται κλιμάκωση, στείλτε ένα παράδειγμα με απόκρυψη, χρονική σήμανση, endpoint, λεπτομέρειες απόκρισης και αναγνωριστικό αιτήματος, όπου είναι διαθέσιμο. Κρατήστε το API secret εκτός της αναφοράς.
Σταματήστε τις τυφλές επαναλήψεις και επιβεβαιώστε την αποκατάσταση
Οι αποτυχίες ελέγχου ταυτότητας πρέπει να ενεργοποιούν διάγνωση και όχι έναν απεριόριστο βρόχο επαναλήψεων. Για ένα ρητά ληγμένο token, μια ελεγχόμενη ανανέωση και μία περιορισμένη επανάληψη μπορεί να είναι κατάλληλες. Για ανεπαρκή δικαιώματα, ανακληθέντα διαπιστευτήρια ή αποκλεισμένη διαδρομή δικτύου, οι επαναλήψεις δεν θα διορθώσουν τη διαμόρφωση.
Πριν επαναλάβετε μια λειτουργία εγγραφής, ελέγξτε τη συμπεριφορά idempotency ή διαχείρισης διπλότυπων του παρόχου. Αυτό έχει σημασία όταν ένας ενδιάμεσος καθιστά αβέβαιο το αρχικό αποτέλεσμα.
Η αποκατάσταση έχει ολοκληρωθεί όταν η προβλεπόμενη λειτουργία επιτυγχάνει από την αρχική ανάπτυξη, όλοι οι σχετικοί workers χρησιμοποιούν τη σωστή διαμόρφωση και η παρακολούθηση δεν εμφανίζει συνεχιζόμενες αποτυχίες ελέγχου ταυτότητας. Παρακολουθείτε ξεχωριστά την κατάσταση HTTP και τα σφάλματα σε επίπεδο εφαρμογής, με ειδοποιήσεις που προσδιορίζουν το επηρεαζόμενο endpoint και περιβάλλον χωρίς να εκθέτουν διαπιστευτήρια.
Συχνές ερωτήσεις
Γιατί το αίτημα λειτουργεί τοπικά αλλά αποτυγχάνει στην παραγωγή;
Συγκρίνετε τις εκδόσεις μυστικών, τα base URLs, τους εξερχόμενους proxies, τις IP εξόδου, τα ρολόγια συστήματος και τη διαμόρφωση χρόνου εκτέλεσης. Η τοπική επιτυχία αποδεικνύει ότι λειτουργεί μία διαδρομή αιτήματος· δεν αποδεικνύει ότι η παραγωγή στέλνει το ίδιο αίτημα ή έχει τα ίδια δικαιώματα.
Πρέπει να δημιουργήσω αμέσως νέο API key;
Όχι, εκτός αν το τρέχον διαπιστευτήριο δεν είναι έγκυρο, έχει ανακληθεί ή ενδέχεται να έχει εκτεθεί. Ελέγξτε πρώτα αν φτάνει στο σωστό endpoint με την απαιτούμενη μορφή. Η περιττή εναλλαγή μπορεί να προκαλέσει αποτυχίες σε άλλες υπηρεσίες που εξακολουθούν να εξαρτώνται από το υπάρχον key.
Μπορεί ένας λανθασμένος αριθμός παρακολούθησης να προκαλέσει 401 ή 403;
Ένας μη έγκυρος αριθμός παρακολούθησης είναι συνήθως ζήτημα επικύρωσης ή επιπέδου πόρου και όχι απόδειξη μη έγκυρου ελέγχου ταυτότητας. Ωστόσο, η πρόσβαση σε μια αποστολή μπορεί να περιορίζεται από την ιδιοκτησία λογαριασμού. Χρησιμοποιήστε τις τεκμηριωμένες λεπτομέρειες σφάλματος του παρόχου αντί να κάνετε διάγνωση μόνο από τον αριθμό.
Σημαίνει ένα 403 ότι έληξε η συνδρομή μου στο API;
Όχι. Οι περιορισμοί συνδρομής ή δικαιωμάτων χρήσης είναι μία πιθανότητα μόνο αν ο πάροχος τους τεκμηριώνει ή επιστρέφει συγκεκριμένο μήνυμα. Η άρνηση μπορεί επίσης να οφείλεται σε δικαιώματα, πλαίσιο λογαριασμού και πολιτικές ασφαλείας. Μην συμπεραίνετε πρόβλημα χρέωσης μόνο από την κατάσταση HTTP.
Τι πρέπει να συμπεριλάβω σε ένα αίτημα υποστήριξης;
Συμπεριλάβετε τη χρονική σήμανση UTC, τη μέθοδο, το endpoint, το περιβάλλον, την κατάσταση HTTP, το σώμα απόκρισης με απόκρυψη, το αναγνωριστικό αιτήματος και αν το πρόβλημα αναπαράγεται με ελάχιστο αίτημα. Περιγράψτε πρόσφατες αναπτύξεις ή αλλαγές διαπιστευτηρίων. Εξαιρέστε μυστικά και αποκρύψτε δεδομένα αποστολών που δεν είναι απαραίτητα για τη διάγνωση.
Πηγές
- RFC 9110: HTTP Semantics — έλεγχος ταυτότητας HTTP, σημασιολογία κεφαλίδων και οι ορισμοί των 401 και 403.
- RFC 6750: OAuth 2.0 Bearer Token Usage — αποκρίσεις σφαλμάτων bearer token, μη έγκυρα tokens και ανεπαρκές scope.
- 17TRACK API documentation — η ειδική για τον πάροχο αναφορά για την υλοποίηση και την αντιμετώπιση προβλημάτων ενός αιτήματος 17TRACK API.


