Σχήματα δεδομένων: Έλεγχος ταυτότητας

Σχήματα δεδομένων: Έλεγχος ταυτότητας. Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.

Σχήματα δεδομένων

Ανάκτηση · Διακριτικό — Έλεγχος ταυτότητας — Απόκριση

ApiResponse_TokenData_ · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.

dataTokenData Υποχρεωτικό: Παράδειγμα απόκρισης · TokenData.

Παράδειγμα: {"access_token":"EXAMPLE_ACCESS_TOKEN","expires_at":"2026-01-01T12:00:00Z","expires_in":900,"rate_limits":{"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10},"token_type":"Bearer"}
metaContextPageMeta ContextMeta PageMeta RequestMeta Υποχρεωτικό: Μεταδεδομένα απόκρισης.

Παράδειγμα: {"request_id":"example"}

Πρόσθετα πεδία: Όχι

Ανάκτηση · Διακριτικό — Έλεγχος ταυτότητας — Απόκριση

TokenData · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.

access_tokenΣυμβολοσειράΥποχρεωτικό: Διακριτικό για την κεφαλίδα Authorization: Bearer. Ορίστε το SHOPENTLY_ACCESS_TOKEN πριν εκτελέσετε το ξεχωριστό παράδειγμα.

Παράδειγμα: "EXAMPLE_ACCESS_TOKEN"
expires_atΣυμβολοσειράΥποχρεωτικό: Χρόνος λήξης σε UTC. Οι τρέχοντες περιορισμοί πρόσβασης μπορεί να αποκλείσουν το διακριτικό νωρίτερα.

format: "date-time"

Παράδειγμα: "2026-01-01T12:00:00Z"
expires_inΑκέραιοςΠροαιρετικό: 900 δευτερόλεπτα, δηλαδή 15 λεπτά από την έκδοση. Τα αιτήματα δεν παρατείνουν την ισχύ του.

Προεπιλογή: 900Παράδειγμα: 900
rate_limitsTokenRateLimitsData Υποχρεωτικό: Engine ≥ 4.143.0. Κάθε απάντηση token περιλαμβάνει το data.rate_limits της πολιτικής του καταστήματος κατά την έκδοση. Όλα τα κλειδιά μοιράζονται αυτά τα όρια· ένα νέο token δεν τα επαναφέρει. Αλλαγή προγράμματος μπορεί να ισχύσει πριν λήξει το token.

Παράδειγμα: {"auth_per_minute":10,"read_per_minute":60,"write_per_minute":10}
token_typeΣυμβολοσειράΠροαιρετικό: Bearer. Σχήμα ελέγχου ταυτότητας για το επιστρεφόμενο διακριτικό.

const: "Bearer"

Προεπιλογή: "Bearer"Παράδειγμα: "Bearer"

Πρόσθετα πεδία: Όχι

Όρια αιτημάτων

TokenRateLimitsData · Engine ≥ 4.143.0. Κάθε απάντηση token περιλαμβάνει το data.rate_limits της πολιτικής του καταστήματος κατά την έκδοση. Όλα τα κλειδιά μοιράζονται αυτά τα όρια· ένα νέο token δεν τα επαναφέρει. Αλλαγή προγράμματος μπορεί να ισχύσει πριν λήξει το token. Το μηδέν σημαίνει μη διαθέσιμο, όχι απεριόριστο.

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

minimum: 0maximum: 1000000

Παράδειγμα: 10
read_per_minuteΑκέραιοςΥποχρεωτικό: Αιτήματα ανάγνωσης ανά λεπτό.

minimum: 0maximum: 1000000

Παράδειγμα: 60
write_per_minuteΑκέραιοςΥποχρεωτικό: Αιτήματα εγγραφής ανά λεπτό· η τιμή δεν εκχωρεί δικαιώματα εγγραφής.

minimum: 0maximum: 1000000

Παράδειγμα: 10

Πρόσθετα πεδία: Όχι

Ανάκτηση · Διακριτικό — Έλεγχος ταυτότητας — Περιεχόμενο αιτήματος

TokenRequest · Πεδία, τύποι και περιορισμοί δεδομένων που δέχεται ή επιστρέφει το API.

ΑντικείμενοΠρόσθετα πεδία: Όχι

Πρόσθετα πεδία: Όχι