La ce folosesc tokenurile de acces
Un token de acces (numit și cheie API) permite propriului tău software, unui dezvoltator sau unui instrument extern să citească date din magazin prin API-ul Storeep. Fiecare token are propriile permisiuni, propria fereastră de date și propria dată de expirare, așa că poți da fiecărui instrument exact ce are nevoie și îl poți elimina oricând, fără să îți împarți parola.
Deschide Setări > Jetoane de acces. Butonul Vezi documentația deschide documentația API, cu endpoint-urile, modul de trimitere a tokenului și limitele de cereri. Trimite acea pagină dezvoltatorului tău.
Vrei în schimb să conectezi un asistent AI precum Claude sau ChatGPT? Pentru asta nu se folosesc tokenuri de acces. Vezi Conectarea unui asistent AI.
Crearea unui token
Dă clic pe Creare jeton nou, completează formularul și dă clic pe Creare.
- Numele jetonului: o etichetă după care îl recunoști în listă, de exemplu „Sincronizare contabilitate”. Doar tu o vezi.
- Permisiuni: bifează cel puțin una:
- Citește produsele: listele de produse, detaliile, variantele și stocul.
- Citește comenzile: istoricul comenzilor, detaliile, statusurile și liniile comenzii.
- Citește webhook-urile: vede configurările webhook-urilor și jurnalele de livrare.
- Gestionează webhook-urile: creează, actualizează și șterge abonamente webhook prin API.
- Acces la date: cât de în urmă poate citi tokenul.
- Ultimele 24 de ore: doar datele create în ultimele 24 de ore. Cea mai sigură variantă, bună pentru sincronizări în timp real.
- Setați data de început: doar datele create la sau după o dată pe care o alegi în Data de început a accesului la date.
- Tot timpul: toate datele tale, fără limită de dată.
- Expirare: Nu expiră niciodată sau Setați data de expirare ca să alegi o dată de până la un an înainte. După acea dată, tokenul nu mai funcționează de la sine.
Copiază tokenul acum
După ce dai clic pe Creare, fereastra afișează Tokenul dvs. de acces cu un buton de copiere. Acest token este afișat o singură dată. Copiază-l și păstrează-l într-un loc sigur, de exemplu un manager de parole. Storeep nu îl poate afișa din nou. Dacă îl pierzi, șterge tokenul și creează unul nou.
Tratează-l ca pe o parolă. Nu-l pune niciodată în codul unui site, în depozite publice, în capturi de ecran sau în mesaje de chat.
Lista de tokenuri
- Nume, cu data la care a fost creat.
- Permisiuni: de exemplu Citire produse sau Citire comenzi.
- Acces la date: Ultimele 24 de ore, Toate datele sau De la o dată.
- Expirare: o dată sau Niciodată.
- Ultima utilizare: când a folosit ultima dată un instrument tokenul sau Niciodată.
Există un număr maxim de tokenuri pe magazin. Când îl atingi, butonul Creare jeton nou dispare până când ștergi unul.
Editarea unui token
Dă clic pe un token ca să-i schimbi numele, permisiunile, accesul la date sau expirarea. Valoarea tokenului rămâne aceeași, așa că instrumentul care îl folosește continuă să funcționeze cu noile reguli.
Ștergerea unui token
Bifează unul sau mai multe tokenuri și alege Ștergeți jetoanele sau folosește butonul coș de gunoi de pe un rând. Tokenul nu mai funcționează imediat, iar orice instrument care îl folosește primește o eroare.
Sfaturi
- Dă fiecărui instrument propriul token, ca să poți elimina unul fără să le strici pe celelalte.
- Alege cea mai mică fereastră de date care funcționează.
- Setează o dată de expirare pentru colaboratori independenți (freelanceri) și lucrări ocazionale.
- Un token care arată mult timp Niciodată la Ultima utilizare probabil nu mai este necesar. Șterge-l.
- Ca Storeep să trimită evenimentele comenzilor la serverul tău, în loc ca serverul tău să le ceară, folosește webhook-uri.