Για τι χρησιμεύουν τα tokens πρόσβασης
Τα tokens πρόσβασης επιτρέπουν σε εξωτερικές εφαρμογές (τα δικά σας σενάρια, ενσωματώσεις, εργαλεία ανάλυσης ή επεξεργαστές webhook) να διαβάζουν δεδομένα από το κατάστημά σας μέσω του Storeep API. Κάθε token έχει περιορισμένο σύνολο δικαιωμάτων και προαιρετική ημερομηνία λήξης. Τα tokens είναι πιο ασφαλή από την κοινοποίηση των διαπιστευτηρίων λογαριασμού σας γιατί μπορούν να περιοριστούν μόνο σε αυτό που χρειάζεται η ενσωμάτωση και να ανακληθούν μεμονωμένα ανά πάσα στιγμή.
Για διαχείριση tokens, μεταβείτε στις Ρυθμίσεις → Tokens πρόσβασης. Ένα κουμπί Προβολή τεκμηρίωσης στον πίνακα συνδέεται με την αναφορά API.
Όρια tokens
- Μέγιστο 40 tokens πρόσβασης ανά κατάστημα. Το κουμπί Δημιουργία νέου token είναι κρυφό όταν επιτευχθεί αυτό το όριο.
- Τα tokens παρατίθενται με νεότερα πρώτα, σελιδοποιημένα σε 20 ανά σελίδα.
Δημιουργία token
Κάντε κλικ στο Δημιουργία νέου token, συμπληρώστε τη φόρμα και κάντε κλικ στο Δημιουργία.
Όνομα token
- Υποχρεωτικό.
- Μέγιστο 50 χαρακτήρες.
- Χρησιμοποιείται μόνο για αναγνώριση στη λίστα tokens. Δεν αποστέλλεται ποτέ σε τρίτους.
Δικαιώματα
Επιλέξτε τουλάχιστον ένα από τα τέσσερα διαθέσιμα εύρη δικαιωμάτων. Κάθε εύρος είναι ανεξάρτητο:
- Ανάγνωση προϊόντων: πρόσβαση σε καταχωρήσεις προϊόντων, λεπτομέρειες, παραλλαγές και δεδομένα αποθέματος.
- Ανάγνωση παραγγελιών: πρόσβαση σε ιστορικό παραγγελιών, λεπτομέρειες, καταστάσεις και στοιχεία γραμμής.
- Ανάγνωση webhooks: προβολή διαμορφώσεων webhook και αρχείων παράδοσης.
- Διαχείριση webhooks: δημιουργία, ενημέρωση και διαγραφή συνδρομών webhook.
Πρέπει να επιλέξετε τουλάχιστον ένα εύρος. Κάθε εύρος που δεν επιλέγεται είναι απρόσιτο σε αυτό το token ακόμα και αν υπάρχει η κατάλληλη διαδρομή API.
Πρόσβαση δεδομένων
Αυτή η ρύθμιση ελέγχει πόσο μακριά στο παρελθόν μπορεί το token να έχει πρόσβαση στα δεδομένα σας. Επιλέξτε την πιο περιοριστική επιλογή που εξυπηρετεί ακόμα τις ανάγκες της ενσωμάτωσης.
- Τελευταίες 24 ώρες (προεπιλογή): το token μπορεί να έχει πρόσβαση μόνο σε δεδομένα των τελευταίων 24 ωρών. Συνιστάται για ενσωματώσεις πραγματικού χρόνου όπως ζωντανές ροές παραγγελιών.
- Ορισμός ημερομηνίας έναρξης: το token μπορεί να έχει πρόσβαση σε δεδομένα από συγκεκριμένη ημερολογιακή ημερομηνία και μετά. Όταν επιλεγεί, εμφανίζεται ένας επιλογέας ημερομηνίας Ημερομηνία έναρξης πρόσβασης δεδομένων.
- Όλο τον χρόνο: χωρίς περιορισμό ημερομηνίας. Το token μπορεί να έχει πρόσβαση σε όλα τα ιστορικά δεδομένα. Χρησιμοποιήστε μόνο όταν η ενσωμάτωση χρειάζεται πραγματικά πλήρες ιστορικό.
Λήξη
- Δεν λήγει ποτέ (προεπιλογή): το token ισχύει επ' αόριστον μέχρι να διαγραφεί χειροκίνητα.
- Ορισμός ημερομηνίας λήξης: όταν επιλεγεί, εμφανίζεται ένας επιλογέας ημερομηνίας Ημερομηνία λήξης. Η ημερομηνία πρέπει να είναι τουλάχιστον μία ημέρα στο μέλλον και το πολύ ένα χρόνο από σήμερα. Μετά την ημερομηνία λήξης, το token σταματά να λειτουργεί αυτόματα.
Τιμή token
Αφού κάνετε κλικ στο Δημιουργία, η τιμή token εμφανίζεται μία φορά σε μήνυμα επιτυχίας. Αντιγράψτε και αποθηκεύστε την με ασφάλεια. Το Storeep δεν μπορεί να την εμφανίσει ξανά. Αν τη χάσετε, διαγράψτε το token και δημιουργήστε νέο.
Επεξεργασία token
Κάντε κλικ σε γραμμή token για να επεξεργαστείτε το όνομα, τα δικαιώματα, τη λειτουργία πρόσβασης δεδομένων και την ημερομηνία λήξης. Δεν μπορείτε να ανακτήσετε ή να αλλάξετε την ίδια την τιμή token. Η επεξεργασία αλλάζει μόνο τις ρυθμίσεις που σχετίζονται με το υπάρχον token.
Στήλες λίστας tokens
- Όνομα: η ετικέτα που δώσατε στο token, με την ημερομηνία δημιουργίας του παρακάτω.
- Δικαιώματα: μια λίστα των χορηγηθέντων εύρων.
- Πρόσβαση δεδομένων: εμφανίζει Τελευταίες 24 ώρες, Όλα τα δεδομένα ή Από [ημερομηνία] ανάλογα με τη λειτουργία.
- Λήξη: η ημερομηνία λήξης ή Ποτέ.
- Τελευταία χρήση: η ημερομηνία και ώρα της τελευταίας χρήσης του token για αυθεντικοποιημένο αίτημα API, ή Ποτέ.
Διαγραφή token
Επιλέξτε ένα ή περισσότερα tokens και κάντε κλικ στο Διαγραφή tokens. Τα διαγραμμένα tokens ακυρώνονται αμέσως. Οποιαδήποτε ενσωμάτωση χρησιμοποιεί διαγραμμένο token θα αρχίσει να λαμβάνει σφάλματα αυθεντικοποίησης.
Συμβουλές ασφαλείας
- Χορηγείτε μόνο τα ελάχιστα απαραίτητα δικαιώματα για κάθε ενσωμάτωση.
- Χρησιμοποιείτε πρόσβαση δεδομένων Τελευταίες 24 ώρες για webhooks και ροές πραγματικού χρόνου. Χρησιμοποιείτε Ορισμός ημερομηνίας έναρξης για εργασίες προγραμματισμένου συγχρονισμού.
- Ορίστε ημερομηνία λήξης για tokens που δίνετε σε βραχυπρόθεσμους συνεργάτες ή εφάπαξ ενσωματώσεις.
- Παρακολουθείτε τη στήλη Τελευταία χρήση. Ένα token που δεν έχει χρησιμοποιηθεί ποτέ ή δεν έχει χρησιμοποιηθεί πρόσφατα μπορεί να ανήκει σε ανενεργή ενσωμάτωση και μπορεί να διαγραφεί με ασφάλεια.