Οδηγοί

PAT token στο CloudCart: σύνδεσε Claude, ChatGPT, Gemini με το eshop

PAT token (personal access token) στο CloudCart: πώς το φτιάχνεις, ποια δικαιώματα δίνεις στο Claude, ChatGPT ή Gemini και πώς κόβεις την πρόσβαση αμέσως.

Η ομάδα του CloudCart17 λεπτά ανάγνωσης
Κλειδί με τρία χρωματιστά δαχτυλίδια δίπλα σε laptop με παράθυρο συνομιλίας και μια μικρή βιτρίνα καταστήματος, ενωμένα με μια λεπτή γραμμή
Σε αυτό το άρθρο · 11 ενότητες
  1. Τι είναι το PAT token στο CloudCart
  2. Ποιος χρειάζεται PAT token και πότε
  3. Πώς φτιάχνεις PAT token: βήμα βήμα
  4. Ποια δικαιώματα να δώσεις στο PAT token
  5. Ποια δικαιώματα θέλει ο agent για email, διαφημίσεις και μετρήσεις
  6. Με περιορισμό IP ή χωρίς, και πόση διάρκεια να έχει το token
  7. Πώς σταματάς την πρόσβαση του AI agent
  8. Τι κερδίζεις με PAT token και AI agent
  9. 7 καλές πρακτικές για τα PAT tokens
  10. Λάθη που πρέπει να αποφύγεις και τι σημαίνουν οι απορρίψεις
  11. Συχνές ερωτήσεις

Με λίγα λόγια: το PAT token (Personal Access Token) είναι το κλειδί με το οποίο ένας AI agent, όπως το Claude Code, το ChatGPT Codex ή το Gemini CLI, μπαίνει στο eshop σου στο CloudCart. Το φτιάχνει μόνο ο ιδιοκτήτης στις Ρυθμίσεις → PAT tokens. Το token ξεκινά με cc_pat_, εμφανίζεται μία μόνο φορά και έχει ένα από τρία επίπεδα πρόσβασης: Read Only, Full Access ή Custom Permissions.

Ο οδηγός αυτός αφορά μόνο το κλειδί: πώς το δημιουργείς, ποια δικαιώματα του δίνεις, πότε το δένεις με διεύθυνση IP και πώς σταματάς την πρόσβαση. Πώς εγκαθίσταται ο agent και τι κάνει μετά, θα το βρεις στα άρθρα για το Claude Code και το eshop, για το Cursor. Τα ονόματα των οθονών είναι όπως στον πίνακα διαχείρισης του CloudCart (δες και σύνδεση AI με το CloudCart).

Τι είναι το PAT token στο CloudCart

Το PAT token είναι προσωπικό κλειδί πρόσβασης του ιδιοκτήτη. Με αυτό το Admin GraphQL API του CloudCart και το CloudCart CLI αναγνωρίζουν ποιος στέλνει το αίτημα. Κάθε αίτημα με το token γίνεται στο όνομα του ιδιοκτήτη, αλλά μόνο μέσα στα δικαιώματα, στη διάρκεια και στις διευθύνσεις IP που όρισες στο token.

Το token είναι μια συμβολοσειρά 71 χαρακτήρων: cc_pat_ και 64 τυχαίοι δεκαεξαδικοί χαρακτήρες. Η πλατφόρμα κρατά μόνο το hash του (SHA-256), γι' αυτό η τιμή φαίνεται μία και μοναδική φορά, στο πράσινο πλαίσιο «Token Created Successfully!» μετά τη δημιουργία. Χαμένο token δεν ανακτάται: το διαγράφεις και φτιάχνεις νέο.

PAT token ή API key: ποια είναι η διαφορά

Το PAT token είναι για AI agents και για το Admin GraphQL API, ενώ το API key είναι για το REST API και για μόνιμες διασυνδέσεις. Στο CloudCart υπάρχουν και δύο ακόμη είδη κλειδιών για headless βιτρίνες, και εύκολα τα μπερδεύεις. Ο πίνακας δείχνει ποιο κάνει τι:

ΚλειδίΠού το φτιάχνειςΣε τι χρησιμεύειΔικαιώματα
PAT tokenΡυθμίσεις → PAT tokensAI agents, CloudCart CLI, Admin GraphQL API (/api/gql)Read Only, Full Access ή επιλεγμένες ενότητες· λήξη και διευθύνσεις IP
API keyΡυθμίσεις → Api keysREST API (/api/v2) για εξωτερικές διασυνδέσεις: ERP, εργαλεία αυτοματισμού, scriptsΌλο το κατάστημα, χωρίς διαχωρισμό ανά ενότητα· από το Starter Pack και πάνω, με όριο ανά πακέτο
Deployment tokenΣελίδα της βιτρίνας Nitrogen, καρτέλα DeploymentsΑνέβασμα headless βιτρίνας με cloudcart nitrogen deployΜόνο deploy αυτής της βιτρίνας
Storefront API tokensΣελίδα της βιτρίνας Nitrogen, καρτέλα Storefront APIΑιτήματα της βιτρίνας προς τον κατάλογο (δημόσιο και ιδιωτικό token)Τα δεδομένα της βιτρίνας

Για AI agent χρειάζεσαι PAT token. Το API key είναι για σταθερές διασυνδέσεις, όπως ένα ERP για eshop, και τα tokens του Nitrogen είναι για όσους χτίζουν δική τους βιτρίνα.

Ποιος χρειάζεται PAT token και πότε

PAT token χρειάζεται κάθε ιδιοκτήτης που θέλει έναν AI agent να διαβάζει ή να αλλάζει το κατάστημα, και όποιος χρησιμοποιεί το CloudCart CLI. Η λειτουργία δεν έχει περιορισμό πακέτου: η οθόνη PAT tokens είναι ίδια στο Baby Pack, στο Starter Pack, στο CC Pro και στο CC Master.

  • Συνδέεις τον agent για πρώτη φορά. Μόλις επικολλήσεις την πρόταση από την κάρτα «Σύνδεσε το κατάστημά σου με AI agent» στον πίνακα ελέγχου, ο agent εγκαθιστά μόνος του ό,τι χρειάζεται και στο τέλος σου ζητά δύο πράγματα: τη διεύθυνση του καταστήματος και ένα PAT token.
  • Θέλεις μόνο αναφορές. Ένας agent που σου λέει κάθε πρωί πωλήσεις, απόθεμα και εγκαταλελειμμένα καλάθια τα βγάζει πέρα με token Read Only.
  • Δίνεις στον agent δουλειά σε ένα μόνο μέρος του καταστήματος. Για παράδειγμα μόνο προϊόντα και αποθέματα, χωρίς παραγγελίες και πελάτες: αυτό γίνεται με Custom Permissions.
  • Δουλεύεις σε πολλούς υπολογιστές ή με πολλούς agents. Ξεχωριστό token για τον καθένα σου επιτρέπει να σταματήσεις τον έναν χωρίς να αγγίξεις τους άλλους.

Το token δεν είναι λογαριασμός υπαλλήλου και δεν μετρά στο όριο διαχειριστών του πακέτου. Το Baby Pack περιλαμβάνει 1 διαχειριστή και ο agent δουλεύει χωρίς να πιάσει δεύτερη θέση. Τις τιμές όλων των πακέτων τις βλέπεις στη σελίδα με τις τιμές.

Πώς φτιάχνεις PAT token: βήμα βήμα

Το PAT token δημιουργείται από την οθόνη Ρυθμίσεις → PAT tokens (στον πίνακα διαχείρισης η διαδρομή είναι Settings → Account → PAT Tokens) ή από το μενού του προφίλ κάτω αριστερά → PAT tokens. Χρειάζονται όνομα και επίπεδο πρόσβασης, τα υπόλοιπα είναι προαιρετικά.

  1. Μπες ως ιδιοκτήτης. Μόνο ο ιδιοκτήτης του καταστήματος δημιουργεί και διαχειρίζεται tokens. Ένας διαχειριστής ή moderator παίρνει το μήνυμα «Only store owners can manage CLI tokens» και στα δικαιώματα των υπαλλήλων δεν υπάρχει επιλογή για να του το αναθέσεις.
  2. Άνοιξε τα PAT tokens. Πάνω υπάρχει ο μετρητής «N of 100 tokens»: έως 100 tokens ανά ιδιοκτήτη. Αν δεν έχεις ακόμη token, πάτα Create Your First Token, αλλιώς Create Token.
  3. Συμπλήρωσε τα Token Details. Το Token Name είναι υποχρεωτικό (έως 100 χαρακτήρες): γράψε για ποιον είναι, π.χ. «Claude Code, laptop γραφείου». Το Description είναι προαιρετικό (έως 500 χαρακτήρες).
  4. Διάλεξε επίπεδο στα Permissions. Τρεις κάρτες: Read Only (με την ένδειξη «Recommended» και επιλεγμένη από προεπιλογή), Full Access και Custom Permissions. Ποιο ταιριάζει πότε, θα το δεις στην επόμενη ενότητα.
  5. Άνοιξε τα Advanced Settings, αν θέλεις λήξη ή IP. Η ενότητα είναι κλειστή. Στο Token Validity απενεργοποίησε το «No expiration» και διάλεξε ημερομηνία λήξης. Στο IP Restrictions προσθέτεις με το Add IP Address έως 20 διευθύνσεις ή εύρη.
  6. Πάτα Generate Token. Εμφανίζεται το πλαίσιο «Token Created Successfully!» με ολόκληρο το token και κουμπί Copy. Αντέγραψέ το αμέσως: μετά το Done η τιμή χάνεται για πάντα. Το κλικ έξω από το παράθυρο δεν το κλείνει, ώστε να μη χάσεις το token κατά λάθος.
  7. Δώσε το token στον agent. Επικόλλησέ το στη συνομιλία όταν σου το ζητήσει, μαζί με τη διεύθυνση του καταστήματος χωρίς https:// (π.χ. tokatastimasou.cloudcart.net ή tokatastimasou.gr). Ο agent το χρησιμοποιεί μόνο στην εντολή σύνδεσης και το κρατά στον υπολογιστή σου.
  8. Έλεγξε με μια ερώτηση. Η οθόνη δεν έχει κουμπί δοκιμής. Γράψε στον agent «Πόσες παραγγελίες είχα χθες;». Αν απαντήσει, η στήλη Last used at του token θα δείξει την ώρα του αιτήματος.

Σημαντικό: το token δουλεύει από κάθε υπολογιστή για όποιον το έχει, εκτός αν έχεις ορίσει διευθύνσεις IP. Φύλαξέ το σαν κωδικό: μην το στέλνεις με email, μην το φωτογραφίζεις και μην το βάζεις σε κοινόχρηστα έγγραφα.

Ποια δικαιώματα να δώσεις στο PAT token

Ξεκίνα με Read Only και πήγαινε σε ευρύτερη πρόσβαση όταν ο agent πρέπει να αλλάξει κάτι. Είναι η αρχή των ελάχιστων δικαιωμάτων (least privilege), που προτείνουν και το NIST και το OWASP: κάθε κλειδί έχει ακριβώς όση πρόσβαση χρειάζεται η δουλειά.

ΕπίπεδοΤι επιτρέπειΠότε να το διαλέξεις
Read OnlyΔιαβάζει τα πάντα, δεν αλλάζει τίποτα. Κάθε αλλαγή απορρίπτεται.Αναφορές, KPI, ερωτήσεις για απόθεμα και παραγγελίες, οι πρώτες μέρες με τον agent
Full AccessΔιαβάζει και αλλάζει τα πάντα στο κατάστημαΟ agent στήνει το κατάστημα, γράφει περιγραφές, αλλάζει τιμές και ρυθμίσεις
Custom PermissionsΜόνο τις επιλεγμένες ενότητες, την καθεμία με None, Read ή Read & WriteΟ agent δουλεύει σε ένα μέρος: π.χ. προϊόντα και αποθέματα

Στα Custom Permissions υπάρχουν 8 γραμμές: Products, Orders, Customers, Inventory, Discounts, Blog, Settings και Webhooks. Τα Inventory και Discounts δεν έχουν επιλογή μόνο ανάγνωσης: ένας agent που πρέπει να δει τα αποθέματα παίρνει πλήρη πρόσβαση στο Inventory. Αν αφήσεις όλες τις γραμμές στο None, το token αποθηκεύεται ως Read Only. Κάτω υπάρχουν τα γρήγορα κουμπιά Select all as Read, Select all as Read & Write και Clear all.

Ποια δουλειά θέλει ποια δικαιώματα

Ο πίνακας καλύπτει τις πιο συχνές δουλειές που δίνουν οι έμποροι στον agent. Οι προτάσεις είναι παραδείγματα που μπορείς να επικολλήσεις όπως είναι:

ΔουλειάΠρόταση στον agentΕλάχιστα δικαιώματα
Πρωινή αναφορά και KPI«Σύγκρινε τα χθεσινά έσοδα με την ίδια μέρα της περασμένης εβδομάδας.»Read Only
Νέος τιμοκατάλογος από τον προμηθευτή«Ενημέρωσε τις τιμές με βάση τους κωδικούς και δείξε μου ποιοι λείπουν.»Products: Read & Write
Λίστα παραγγελίας προς προμηθευτή«Ποια προϊόντα έχουν κάτω από 5 τεμάχια; Φτιάξε πίνακα.»Products: Read + Inventory
Προσφορά για Black Friday«Κάνε έκπτωση 15% στην κατηγορία "Χειμερινά" μέχρι την Κυριακή.»Discounts + Products: Read
Άρθρο στο blog του καταστήματος«Γράψε πρόχειρο για φροντίδα επιδερμίδας τον χειμώνα.»Blog: Read & Write
Αναφορά ανά κατηγορία«Δείξε μου τις πωλήσεις ανά κατηγορία για τον Οκτώβριο.»Settings: Read (οι αναφορές είναι στα Settings)

Ποιους αριθμούς να παρακολουθείς και πώς τους υπολογίζει ο agent, το εξηγούμε στο άρθρο τα 10 KPI του eshop. Περισσότερες έτοιμες προτάσεις θα βρεις στα 30 prompts για παραγγελίες, απόθεμα, τιμές και SEO.

Ποια δικαιώματα θέλει ο agent για email, διαφημίσεις και μετρήσεις

Για το marketing ο agent χρειάζεται τα Settings, γιατί στο Admin GraphQL API οι καμπάνιες, οι εφαρμογές, οι ρυθμίσεις SEO και οι αναφορές του καταστήματος ανήκουν σε αυτή την ενότητα. Οι συνδρομητές και οι πελάτες είναι στα Customers. Το PAT token ανοίγει στον agent μόνο το κατάστημα στο CloudCart: τα αποτελέσματα στο Meta Ads Manager, στο Google Ads, στο TikTok Ads Manager και στο Google Search Console τα διαβάζει με ξεχωριστή πρόσβαση, που τη δίνεις στην αντίστοιχη υπηρεσία.

ΔουλειάΤι κάνει ο agent στο CloudCartΕλάχιστα δικαιώματα του tokenΤι μένει έξω από το token
Καμπάνια email στο Marketing SuiteΓράφει την καμπάνια από τα πραγματικά προϊόντα και τις τιμές, διαλέγει το segment συνδρομητών, ετοιμάζει το πρότυποSettings: Read & Write, Customers: Read, Products: ReadΤίποτα: τα email, τα SMS και τα web push είναι στο Marketing του καταστήματος
Meta (Facebook και Instagram)Ελέγχει το Pixel ID και το Conversions API στις Εφαρμογές → XML Feed → Facebook, γράφει διαφημιστικά κείμενα για τα best sellersSettings: Read, Products: Read, Orders: ReadΤους προϋπολογισμούς και τα αποτελέσματα στο Meta Ads Manager
Google Ads και Google ShoppingΒελτιώνει τίτλους και περιγραφές των προϊόντων που μπαίνουν στο feed, ελέγχει το Google Dynamic Remarketing και το Google Tag ManagerProducts: Read & Write, Settings: ReadΤις καμπάνιες και τα έξοδα στον λογαριασμό Google Ads
TikTokΕλέγχει την εφαρμογή TikTok Pixel και τα προϊόντα που μπαίνουν στον κατάλογο για το TikTokSettings: Read, Products: ReadΤις καμπάνιες και τους προϋπολογισμούς στο TikTok Ads Manager
Google Search ConsoleΕλέγχει την επαλήθευση στις Εφαρμογές → Google Search Console, γράφει τίτλους SEO και meta descriptions στα προϊόνταProducts: Read & Write, Settings: ReadΤις αναζητήσεις, τα κλικ και τις θέσεις στο Search Console
Μετρήσεις καταστήματοςΥπολογίζει έσοδα, αριθμό παραγγελιών, μέση παραγγελία, ποσοστό επαναλαμβανόμενων πελατών, best sellers και χαμηλά αποθέματαRead OnlyΤις συνεδρίες από το GA4, αν τις θέλεις και από εκεί

Κάθε κανάλι χωριστά το αναλύουμε στους οδηγούς για καμπάνια email στο CloudCart βήμα βήμα, διαφήμιση στο Facebook και στο Instagram, Google Ads για eshop, διαφήμιση στο TikTok και Google Search Console για eshop.

Σημαντικό: για διαφημιστικά κείμενα και email ο agent δεν χρειάζεται να βλέπει τους πελάτες ονομαστικά. Δώσε Customers: Read μόνο όταν η δουλειά είναι segment συνδρομητών ή αναφορά για τους επαναλαμβανόμενους πελάτες.

Με περιορισμό IP ή χωρίς, και πόση διάρκεια να έχει το token

Περιορισμό IP βάζεις όταν ο agent δουλεύει από διεύθυνση που δεν αλλάζει: γραφείο, server ή CI. Αν δουλεύεις από laptop στο σπίτι και ο πάροχος internet σου δίνει δυναμική IP, άφησε τη λίστα κενή και βάλε μικρή διάρκεια.

  • Κενή λίστα σημαίνει ότι το token δουλεύει από κάθε διεύθυνση. Αυτή είναι η προεπιλογή.
  • Μία διεύθυνση γράφεται ως 192.168.1.100, ολόκληρο δίκτυο ως 192.168.1.0/24 (256 διευθύνσεις). Υποστηρίζονται IPv4, IPv6 και εύρη CIDR, έως 20 ανά token.
  • Αίτημα από άλλη διεύθυνση απορρίπτεται με IP_NOT_ALLOWED και η στήλη Last used at δεν αλλάζει. Έτσι δείχνει μόνο τα επιτυχημένα αιτήματα.

Η διάρκεια (Token Validity) είναι από προεπιλογή «No expiration»: το token δουλεύει μέχρι να το διαγράψεις ή να το απενεργοποιήσεις. Η ημερομηνία λήξης πρέπει να είναι στο μέλλον. Βάλε υπενθύμιση στο ημερολόγιο για τη λήξη, ώστε ο agent να μη σταματήσει ξαφνικά. Λογική πρακτική είναι 30 έως 90 ημέρες για token σε laptop, και χωρίς λήξη μόνο για token δεμένο με την IP ενός server.

Πώς σταματάς την πρόσβαση του AI agent

Η πρόσβαση σταματά αμέσως, σε όλους τους υπολογιστές, όταν απενεργοποιήσεις ή διαγράψεις το token στα PAT tokens. Οι δύο τρόποι έχουν διαφορετικές συνέπειες:

ΕνέργειαΠούΤι γίνεταιΑναστρέφεται;
Απενεργοποίηση (Active)Ο διακόπτης στη γραμμή του tokenΚάθε αίτημα απορρίπτεται· το token μένει στη λίσταΝαι: το ενεργοποιείς και το ίδιο token δουλεύει ξανά
Διαγραφή (Delete)Το κουμπί στη γραμμή, με επιβεβαίωση «This action cannot be undone.»Το hash καταστρέφεται οριστικάΌχι: φτιάχνεις νέο token με νέα τιμή
cloudcart auth logoutΤο τερματικό του υπολογιστή με τον agentΣβήνει τη σύνδεση μόνο σε αυτόν τον υπολογιστήΝαι, με νέα σύνδεση

Η απενεργοποίηση βολεύει για παύση, για παράδειγμα όσο είσαι σε άδεια. Η διαγραφή είναι η σωστή κίνηση μόλις υποψιαστείς ότι το token έπεσε σε ξένα χέρια. Η επεξεργασία δεν αλλάζει την τιμή: για νέο κλειδί με τα ίδια δικαιώματα διαγράφεις το παλιό και φτιάχνεις νέο. Αν η ιδιοκτησία του καταστήματος περάσει σε άλλον, τα PAT tokens του προηγούμενου ιδιοκτήτη δεν μεταφέρονται στον νέο: εκείνος φτιάχνει δικά του.

Τι κερδίζεις με PAT token και AI agent

Με σωστά ρυθμισμένο token μια δουλειά δεκάδων κλικ γίνεται μία πρόταση και ο κίνδυνος μένει υπό έλεγχο. Σε ένα κατάστημα καλλυντικών με 300 προϊόντα, ένας νέος τιμοκατάλογος από τον προμηθευτή σημαίνει να ελέγξεις 300 κωδικούς και 300 τιμές. Ένας agent με token Products: Read & Write συγκρίνει τους κωδικούς, σου δείχνει τις διαφορές και αλλάζει τις τιμές με μία μαζική λειτουργία που τρέχει στο παρασκήνιο.

  • Ταχύτητα. Το Admin GraphQL API δέχεται 300 αιτήματα το λεπτό ανά διεύθυνση καταστήματος και οι μαζικές αλλαγές περνούν ως μία εργασία στο παρασκήνιο αντί για εκατοντάδες ξεχωριστές.
  • Έλεγχος. Ένα token Read Only δεν μπορεί να αλλάξει τίποτα, ακόμη κι αν ο agent κάνει λάθος στο αίτημα. Η απόρριψη ονομάζει ακριβώς το δικαίωμα που λείπει.
  • Ιχνηλασιμότητα. Οι αλλαγές μέσω του token καταγράφονται ως αλλαγές του ιδιοκτήτη. Με ξεχωριστό token για κάθε agent και τη στήλη Last used at βλέπεις ποιο κλειδί δούλεψε και πότε.

Πόσες ώρες την εβδομάδα γλιτώνει αυτό σε ένα τυπικό κατάστημα, το υπολογίσαμε στο άρθρο AI agent για eshop: πόσες ώρες και πόσα χρήματα γλιτώνεις. Οι μαζικές αλλαγές περιγράφονται αναλυτικά στο μαζική αλλαγή τιμών και αποθεμάτων με μία πρόταση.

7 καλές πρακτικές για τα PAT tokens

  1. Ένα token για κάθε agent ή υπολογιστή. Το όνομα λέει ποιος και πού («Gemini CLI, server»). Σταματάς τον έναν χωρίς να σταματήσεις τους άλλους.
  2. Read Only για αρχή. Τις πρώτες μέρες ρώτα τον agent για αναφορές και αποθέματα. Full Access δώσε αφού δεις πώς δουλεύει.
  3. Ζήτα «δείξε μου πρώτα». Πες στον agent να σου δείξει τη λίστα με τις αλλαγές και επιβεβαίωσέ τις πριν τις εφαρμόσει. Έτσι ένα λάθος στο αίτημα φαίνεται πριν φτάσει στο κατάστημα.
  4. Ενεργοποίησε ημερήσια αντίγραφα πριν από το Full Access. Μετά την αντιγραφή της πρότασης από τον πίνακα ελέγχου, ο πίνακας διαχείρισης προτείνει συνδρομή σε ημερήσια αντίγραφα, όταν το κατάστημα μπορεί να την έχει (ξεχωριστή συνδρομή, όχι σε κάθε πακέτο). Με αυτά επαναφέρεις όλο το κατάστημα ή ένα μέρος του στο τελευταίο ημερήσιο αντίγραφο.
  5. Λήξη για το laptop, IP για τον server. Το token σε φορητό υπολογιστή με 30 έως 90 ημέρες, το token σε server δεμένο με τη διεύθυνσή του.
  6. Κοίτα το Last used at μία φορά τον μήνα. Ένα token που δεν χρησιμοποιήθηκε εδώ και εβδομάδες, διάγραψέ το. Η στήλη ενημερώνεται μόνο με επιτυχημένο αίτημα.
  7. Σκέψου τι διαβάζει ο πάροχος. Ο πάροχος του agent (Anthropic, OpenAI, Google) επεξεργάζεται ό,τι διαβάσει ο agent, με τους όρους του λογαριασμού σου σε αυτόν. Αν ο agent δεν χρειάζεται τους πελάτες, μην του δίνεις Customers. Οι υποχρεώσεις σου για τα προσωπικά δεδομένα αναλύονται στο άρθρο για GDPR και cookies στο eshop.

Λάθη που πρέπει να αποφύγεις και τι σημαίνουν οι απορρίψεις

Το πιο συχνό λάθος είναι να κλείσεις το παράθυρο πριν αντιγράψεις το token: τότε η μόνη λύση είναι νέο token. Το δεύτερο είναι το Full Access «για κάθε ενδεχόμενο» σε έναν agent που μόνο διαβάζει αναφορές. Το τρίτο είναι ένα κοινό token για όλα, που μετά δεν μπορείς να σταματήσεις χωρίς να σταματήσεις όλους τους agents.

Όταν ο agent δεν μπορεί να κάνει κάτι, το Admin GraphQL API επιστρέφει κωδικό και μήνυμα. Ο πίνακας δείχνει τα πιο συνηθισμένα:

ΜήνυμαΑιτίαΤι κάνεις
«Invalid or expired token»Λάθος αντιγραφή, απενεργοποιημένο token ή λήξηΕνεργοποίησε ξανά το token ή φτιάξε νέο και συνδέσου πάλι στον agent
«Token has been revoked»Το token διαγράφηκε στα PAT tokensΦτιάξε νέο token και δώσ' το στον agent
«… writes data, which this token's scopes do not allow.»Read Only ή μόνο Read για αυτή την ενότηταToken με Read & Write για την ενότητα
«… needs the `inventory` scope, which this token does not have.»Στα Custom Permissions λείπει η ενότηταΠρόσθεσέ την από το Edit του token
IP_NOT_ALLOWEDΤο αίτημα έρχεται από διεύθυνση εκτός λίσταςΠρόσθεσε τη διεύθυνση ή άδειασε τη λίστα
TOO_MANY_REQUESTS (429)Πάνω από 300 αιτήματα το λεπτό στο κατάστημαΖήτα από τον agent μαζική λειτουργία αντί για επανάληψη ένα ένα

Στο Edit (κλικ στο όνομα στη λίστα) αλλάζεις όνομα, επίπεδο πρόσβασης, διευθύνσεις IP και λήξη, ενώ η τιμή του token μένει ίδια. Τα τρία API του CloudCart και τα όρια του REST API ανά πακέτο περιγράφονται στη σελίδα για developers, και γενικές καλές πρακτικές για προσωπικά tokens θα βρεις και στην τεκμηρίωση του GitHub.

Αν δεν έχεις ακόμη κατάστημα, δες τα πακέτα του CloudCart, φτιάξε το eshop σου και σύνδεσε τον agent με το πρώτο σου PAT token. Αν κολλήσεις κάπου, γράψε μας στο support@cloudcart.com.

Συχνές ερωτήσεις

Είναι ένα προσωπικό κλειδί πρόσβασης που αντικαθιστά τον κωδικό σου όταν ένα πρόγραμμα μιλά με ένα API. Στο CloudCart το PAT token το φτιάχνει ο ιδιοκτήτης, ξεκινά με cc_pat_ και επιτρέπει σε AI agents και στο CloudCart CLI να δουλεύουν στο κατάστημα μόνο με τα δικαιώματα που όρισες.

Μπες ως ιδιοκτήτης και άνοιξε Ρυθμίσεις → PAT tokens ή το μενού του προφίλ κάτω αριστερά → «PAT tokens». Πάτα Create Token, γράψε όνομα, διάλεξε επίπεδο πρόσβασης και πάτα Generate Token. Αντέγραψε το token αμέσως, γιατί εμφανίζεται μόνο μία φορά.

Απενεργοποίησε ή διάγραψε το token στα PAT tokens: η πρόσβαση σταματά αμέσως, σε κάθε υπολογιστή. Η απενεργοποίηση αναστρέφεται, η διαγραφή όχι. Στον ίδιο τον υπολογιστή η εντολή cloudcart auth logout σβήνει την αποθηκευμένη σύνδεση.

Το PAT token είναι για AI agents, για το CloudCart CLI και για το Admin GraphQL API, με επιλογή δικαιωμάτων, λήξης και διευθύνσεων IP. Το API key είναι για το REST API και για σταθερές διασυνδέσεις όπως ένα ERP, με πρόσβαση σε όλο το κατάστημα. Για Claude, ChatGPT ή Gemini χρειάζεσαι PAT token.

Όχι. Το CloudCart κρατά μόνο το hash του token και η τιμή δεν ανακτάται. Διάγραψε το παλιό token, φτιάξε νέο με τα ίδια δικαιώματα και δώσ' το στον agent.

Όχι, PAT tokens φτιάχνει μόνο ο ιδιοκτήτης του καταστήματος και το δικαίωμα δεν ανατίθεται. Ένας υπάλληλος μπορεί να συνδέσει τον agent με σύνδεση μέσω browser: τότε ο agent δουλεύει με τα δικαιώματα του υπαλλήλου για 30 ημέρες και μετά η σύνδεση γίνεται ξανά.

Όχι. Το PAT token δίνει πρόσβαση μόνο στο κατάστημα στο CloudCart: προϊόντα, παραγγελίες, πελάτες, καμπάνιες στο Marketing Suite, εφαρμογές και αναφορές. Τα δεδομένα των διαφημιστικών λογαριασμών και του Search Console ο agent τα διαβάζει με ξεχωριστή πρόσβαση, που τη δίνεις στη Meta, στη Google ή στο TikTok.

Πηγές

  1. NISTcsrc.nist.gov
  2. OWASPcheatsheetseries.owasp.org
  3. τεκμηρίωση του GitHubdocs.github.com
Η ομάδα του CloudCartΕλεγμένο με βάση την τεκμηρίωση της πλατφόρμας. Ερωτήσεις: support@cloudcart.com

Φτιάξε το ηλεκτρονικό σου κατάστημα

Πακέτα από 14 € τον μήνα με ετήσια πληρωμή, χωρίς ΦΠΑ και με 0% προμήθεια στις πωλήσεις. Ερωτήσεις: support@cloudcart.com

Φτιάξε το eshop σου