Έλεγχος ταυτότητας
- Authorization: ApiKey
- Το κλειδί API αποστέλλεται αποκλειστικά στην κεφαλίδα Authorization του POST /api/v1/auth/token. Μην το τοποθετείτε σε JSON, URL ή παραμέτρους ερωτήματος.
- Authorization: Bearer
- Χρησιμοποιήστε το διακριτικό που επιστρέφεται για αιτήματα πόρων και ανανεώστε το σύμφωνα με το expires_at. Το expires_in εκφράζεται σε δευτερόλεπτα.
Γιατί να λάβετε πρώτα διακριτικό;
Το κλειδί API χρησιμοποιείται για τη λήψη διακριτικού. Το διακριτικό ισχύει για 15 λεπτά και μπορεί να χρησιμοποιηθεί σε πολλά αιτήματα. Στους πόρους στέλνετε μόνο το διακριτικό στην κεφαλίδα Authorization: Bearer.
Τα συνηθισμένα αιτήματα δεν περιέχουν το κλειδί API. Ένα διακριτικό που διέρρευσε επιτρέπει πρόσβαση το πολύ μέχρι τη λήξη του. Ένα κλεμμένο κλειδί API μπορεί ακόμη να επιτρέπει τη λήψη νέων διακριτικών.
Πόσο διαρκεί ένα διακριτικό;
- expires_in
- 900 δευτερόλεπτα, δηλαδή 15 λεπτά από την έκδοση. Τα αιτήματα δεν παρατείνουν την ισχύ του.
- expires_at
- Χρόνος λήξης σε UTC. Οι τρέχοντες περιορισμοί πρόσβασης μπορεί να αποκλείσουν το διακριτικό νωρίτερα.
Πότε να λάβετε νέο διακριτικό;
Χρησιμοποιήστε το ίδιο διακριτικό για πολλά αιτήματα και λάβετε νέο πριν από το expires_at. Δεν χρειάζεται νέο διακριτικό πριν από κάθε ενέργεια. Χρησιμοποιήστε το κλειδί API για τη λήψη του.
Άρνηση πρόσβασης και επανάληψη
- 401
- Το 401 δεν σημαίνει πάντα ότι το διακριτικό έληξε. Αν έληξε, λάβετε νέο και επαναλάβετε την ανάγνωση το πολύ μία φορά. Αν η λήψη διακριτικού επιστρέψει 401, ελέγξτε το κλειδί και σταματήστε τις αυτόματες προσπάθειες.
- 403
- Για 403, ελέγξτε δικαιώματα, περιορισμούς IP και πρόγραμμα συνδρομής. Ένα νέο διακριτικό δεν επαναφέρει ανακληθείσα πρόσβαση.
Περιορισμοί IP
- Το διακριτικό πρόσβασης δεν παρακάμπτει τα τρέχοντα δικαιώματα του κλειδιού, τα δικαιώματα του προγράμματος του καταστήματος, την ανάκληση ή τους περιορισμούς IP.
- Περιορίστε το κλειδί στις διευθύνσεις προέλευσης της διασύνδεσης, όπου χρειάζεται.
- Ο διαχειριστής μπορεί να επεξεργαστεί αυτή τη λίστα.
- Γίνονται δεκτές έως 32 διευθύνσεις.
Διαχείριση κλειδιών
- Η διαχείριση κλειδιών API είναι ξεχωριστή από τα δικαιώματα πόρων της διασύνδεσης.
- Μόνο ο owner μπορεί να παραχωρήσει σε ομάδες διοικητικά δικαιώματα προβολής, δημιουργίας, επεξεργασίας ή διαγραφής κλειδιών.
- Ένα εξουσιοδοτημένο μέλος ομάδας εκτελεί μόνο τις ενέργειες που έχουν παραχωρηθεί στην ομάδα.
Όρια αιτημάτων
Engine ≥ 4.143.0. Κάθε απάντηση token περιλαμβάνει το data.rate_limits της πολιτικής του καταστήματος κατά την έκδοση. Όλα τα κλειδιά μοιράζονται αυτά τα όρια· ένα νέο token δεν τα επαναφέρει. Αλλαγή προγράμματος μπορεί να ισχύσει πριν λήξει το token.
- read_per_minute
- Αιτήματα ανάγνωσης ανά λεπτό.
- write_per_minute
- Αιτήματα εγγραφής ανά λεπτό· η τιμή δεν εκχωρεί δικαιώματα εγγραφής.
- auth_per_minute
- Αιτήματα token ανά λεπτό, μαζί με τις αποτυχημένες προσπάθειες ελέγχου ταυτότητας.