Σε τι χρησιμεύουν τα διακριτικά πρόσβασης
Τα διακριτικά πρόσβασης επιτρέπουν στα δικά σας scripts και σε τρίτες ενσωματώσεις να επικοινωνούν με το Storeep API εκ μέρους του καταστήματός σας. Κάθε διακριτικό έχει ένα σταθερό σύνολο δικαιωμάτων, ένα προαιρετικό παράθυρο δεδομένων και μια προαιρετική ημερομηνία λήξης. Τα διακριτικά είναι πιο ασφαλή από το να μοιράζεστε τα στοιχεία σύνδεσης του πίνακα ελέγχου, επειδή ορίζετε ακριβώς τι χρειάζεται κάθε ενσωμάτωση και μπορείτε να το ανακαλέσετε οποιαδήποτε στιγμή.
Για να διαχειριστείτε διακριτικά, μεταβείτε στις Ρυθμίσεις, Διακριτικά πρόσβασης. Το κουμπί Προβολή τεκμηρίωσης ανοίγει την πλήρη αναφορά API σε νέα καρτέλα.
Όρια διακριτικών
- Μπορείτε να διατηρείτε έως 40 διακριτικά πρόσβασης ανά κατάστημα. Όταν φτάσετε τα 40, το κουμπί Δημιουργία νέου διακριτικού εξαφανίζεται μέχρι να διαγράψετε κάποιο.
- Τα διακριτικά εμφανίζονται με τα πιο πρόσφατα πρώτα, 20 ανά σελίδα.
Δημιουργία διακριτικού
Κάντε κλικ στο Δημιουργία νέου διακριτικού, συμπληρώστε τη φόρμα και μετά πατήστε Δημιουργία.
Όνομα διακριτικού
- Υποχρεωτικό, έως 50 χαρακτήρες.
- Χρησιμοποιείται μόνο για να αναγνωρίζετε το διακριτικό στη λίστα σας. Δεν αποστέλλεται ποτέ σε τρίτους.
Δικαιώματα
Επιλέξτε τουλάχιστον ένα από τα τέσσερα scopes. Κάθε ένα είναι ανεξάρτητο και το API απορρίπτει κάθε αίτημα που δεν έχει το απαραίτητο scope (απάντηση 403 "ανεπαρκή δικαιώματα" που αναφέρει το απαιτούμενο scope):
- Ανάγνωση προϊόντων: πρόσβαση σε λίστες προϊόντων, λεπτομέρειες, παραλλαγές και αποθέματα.
- Ανάγνωση παραγγελιών: πρόσβαση σε ιστορικό παραγγελιών, λεπτομέρειες, καταστάσεις και γραμμές ειδών.
- Ανάγνωση webhooks: προβολή και λίστα των ρυθμίσεων webhook σας.
- Διαχείριση webhooks: δημιουργία, ενημέρωση και διαγραφή webhooks.
Αν δεν επιλέξετε τίποτα, η δημιουργία αποτυγχάνει με το μήνυμα "Παρακαλώ επιλέξτε τουλάχιστον ένα δικαίωμα". Τα ίδια τα webhooks ρυθμίζονται στις Ρυθμίσεις, Webhooks. Αυτά τα scopes ελέγχουν μόνο την πρόσβαση μέσω API.
Πρόσβαση στα δεδομένα
Αυτό ορίζει πόσο πίσω στο χρόνο μπορεί το διακριτικό να διαβάζει τα δεδομένα σας. Επιλέξτε την πιο περιοριστική επιλογή που καλύπτει τις ανάγκες σας.
- Τελευταίες 24 ώρες (προεπιλογή): το διακριτικό βλέπει μόνο δεδομένα από ένα κυλιόμενο παράθυρο 24 ωρών, που υπολογίζεται σε κάθε αίτημα. Πιο ασφαλές, ιδανικό για ζωντανές ροές.
- Ορισμός ημερομηνίας έναρξης: το διακριτικό βλέπει μόνο δεδομένα που δημιουργήθηκαν από μια ημερομηνία και μετά που θα επιλέξετε. Ενεργοποιεί επιλογέα Ημερομηνία έναρξης πρόσβασης στα δεδομένα.
- Όλα τα δεδομένα: χωρίς χρονικό περιορισμό, το διακριτικό διαβάζει όλο το ιστορικό. Χρησιμοποιήστε το μόνο αν το απαιτεί η ενσωμάτωση.
Λήξη
- Χωρίς λήξη (προεπιλογή): ισχύει μέχρι να το διαγράψετε.
- Ορισμός ημερομηνίας λήξης: εμφανίζει επιλογέα Ημερομηνία λήξης. Η ημερομηνία πρέπει να είναι τουλάχιστον μία μέρα μετά και το πολύ ένα έτος από σήμερα. Μετά τη λήξη, το διακριτικό σταματά να λειτουργεί αυτόματα και κάθε κλήση API επιστρέφει "access token has expired".
Η τιμή του διακριτικού (εμφανίζεται μία φορά)
Αφού πατήσετε Δημιουργία, η τιμή του διακριτικού (ένα UUID) εμφανίζεται μία φορά στο μήνυμα επιτυχίας. Αντιγράψτε και αποθηκεύστε το αμέσως κάπου ασφαλές. Το Storeep δεν το εμφανίζει ξανά και δεν μπορεί να το ανακτήσει. Αν το χάσετε, διαγράψτε το διακριτικό και δημιουργήστε νέο.
Χρήση διακριτικού με το API
- Στείλτε την τιμή σε HTTP header ως Authorization: Bearer YOUR_TOKEN. Αν λείπει ή είναι λανθασμένο, επιστρέφει σφάλμα 401.
- Κάθε διακριτικό έχει όριο 60 αιτήματα ανά 60 δευτερόλεπτα. Αν το ξεπεράσετε, λαμβάνετε απάντηση 429 "rate limit exceeded". Περιμένετε και δοκιμάστε ξανά μετά την επαναφορά του παραθύρου.
- Τα endpoints λίστας δέχονται φίλτρο market (έναν κωδικό χώρας ή έως 20), καθώς και limit (1 έως 50, προεπιλογή 20), page (προεπιλογή 1) και ταξινόμηση κατά created_at ή updated_at. Δείτε Προβολή τεκμηρίωσης για URLs και λεπτομέρειες.
Επεξεργασία διακριτικού
Κάντε κλικ σε οποιαδήποτε γραμμή διακριτικού για να επεξεργαστείτε το όνομα, τα δικαιώματα, τον τρόπο πρόσβασης στα δεδομένα και τη λήξη. Δεν μπορείτε να δείτε ή να αλλάξετε την τιμή του διακριτικού, η επεξεργασία ενημερώνει μόνο τις ρυθμίσεις του υπάρχοντος διακριτικού, ώστε οι ενσωματώσεις να συνεχίζουν να λειτουργούν χωρίς νέο διακριτικό.
Στήλες λίστας διακριτικών
- Όνομα: η ετικέτα που δώσατε, με ημερομηνία και ώρα δημιουργίας από κάτω.
- Δικαιώματα: τα granted scopes (ή Κανένα).
- Πρόσβαση στα δεδομένα: εμφανίζει Τελευταίες 24 ώρες, Όλα τα δεδομένα ή Από [ημερομηνία].
- Λήξη: η ημερομηνία λήξης ή Ποτέ.
- Τελευταία χρήση: ημερομηνία και ώρα της τελευταίας επιτυχούς κλήσης API με το διακριτικό ή Ποτέ.
Διαγραφή διακριτικού
Επιλέξτε ένα ή περισσότερα διακριτικά και κάντε κλικ στο Διαγραφή διακριτικών ή χρησιμοποιήστε τη διαγραφή ανά γραμμή. Η διαγραφή είναι άμεση και οριστική: κάθε ενσωμάτωση που χρησιμοποιεί ακόμα αυτή την τιμή θα λαμβάνει αμέσως σφάλματα ταυτοποίησης 401.
Συμβουλές ασφαλείας
- Δώστε μόνο τα scopes που χρειάζεται πραγματικά μια ενσωμάτωση.
- Κρατήστε την πρόσβαση Τελευταίες 24 ώρες για ζωντανές ροές και χρησιμοποιήστε Ορισμός ημερομηνίας έναρξης για προγραμματισμένες συγχρονίσεις.
- Ορίστε ημερομηνία λήξης για εργολάβους μικρής διάρκειας ή μεμονωμένες εργασίες.
- Παρακολουθήστε τη στήλη Τελευταία χρήση: ένα διακριτικό που είναι Ποτέ ή ανενεργό για καιρό πιθανότατα ανήκει σε ανενεργή ενσωμάτωση και είναι ασφαλές να διαγραφεί.