Na čo slúžia prístupové tokeny
Prístupový token (nazývaný aj API kľúč) umožňuje vášmu vlastnému softvéru, vývojárovi alebo nástroju tretej strany čítať údaje z vášho obchodu cez Storeep API. Každý token má vlastné oprávnenia, časové okno údajov a dátum vypršania, takže každému nástroju dáte presne to, čo potrebuje, a kedykoľvek ho môžete odobrať bez zdieľania hesla.
Otvorte Nastavenia > Prístupové tokeny. Tlačidlo Zobraziť dokumentáciu otvorí referenciu API s koncovými bodmi, spôsobom posielania tokenu a limitmi požiadaviek. Túto stránku pošlite svojmu vývojárovi.
Chcete namiesto toho pripojiť AI asistenta, napríklad Claude alebo ChatGPT? Na to sa prístupové tokeny nepoužívajú. Pozrite si článok Pripojenie AI asistenta.
Vytvorenie tokenu
Kliknite na Vytvoriť nový token, vyplňte formulár a kliknite na Vytvoriť.
- Názov tokenu: označenie, podľa ktorého ho spoznáte v zozname, napríklad „Synchronizácia účtovníctva“. Vidíte ho len vy.
- Oprávnenia: označte aspoň jedno:
- Čítanie produktov: zoznamy produktov, podrobnosti, varianty a zásoby.
- Čítanie objednávok: história objednávok, podrobnosti, stavy a položky.
- Čítanie webhookov: zobrazenie konfigurácií webhookov a záznamov o doručení.
- Správa webhookov: vytváranie, úprava a odstraňovanie odberov webhookov cez API.
- Prístup k údajom: ako ďaleko do minulosti môže token čítať.
- Posledných 24 hodín: len údaje vytvorené za posledných 24 hodín. Najbezpečnejšia možnosť, vhodná na priebežnú synchronizáciu.
- Nastaviť dátum začiatku: len údaje vytvorené v deň alebo po dni, ktorý vyberiete v poli Dátum začiatku prístupu k údajom.
- Celé obdobie: všetky vaše údaje bez časového obmedzenia.
- Vypršanie platnosti: Nikdy nevyprší alebo Nastaviť dátum vypršania, kde vyberiete dátum najviac rok dopredu. Po tomto dátume token sám prestane fungovať.
Skopírujte token hneď
Po kliknutí na Vytvoriť okno zobrazí Váš prístupový token s tlačidlom kopírovania. Tento token sa zobrazí len raz. Skopírujte ho a uložte na bezpečné miesto, napríklad do správcu hesiel. Storeep ho už znova zobraziť nevie. Ak ho stratíte, token odstráňte a vytvorte nový.
Zaobchádzajte s ním ako s heslom. Nikdy ho nevkladajte do kódu webu, verejných repozitárov, snímok obrazovky ani do správ v chate.
Zoznam tokenov
- Meno s dátumom vytvorenia.
- Oprávnenia: napríklad Prečítané produkty alebo Prečítané objednávky.
- Prístup k údajom: Posledných 24 hodín, Všetky údaje alebo Od určitého dátumu.
- Vypršanie platnosti: dátum alebo Nikdy.
- Naposledy použité: kedy nástroj naposledy použil token, alebo Nikdy.
Počet tokenov na obchod je obmedzený. Keď dosiahnete maximum, tlačidlo Vytvoriť nový token zmizne, kým niektorý neodstránite.
Úprava tokenu
Kliknite na token a zmeňte jeho názov, oprávnenia, prístup k údajom alebo vypršanie. Hodnota tokenu zostáva rovnaká, takže nástroj, ktorý ho používa, funguje ďalej s novými pravidlami.
Odstránenie tokenu
Označte jeden alebo viac tokenov a vyberte Odstrániť tokeny, alebo použite tlačidlo koša v riadku. Token okamžite prestane fungovať a každý nástroj, ktorý ho používa, dostane chybu.
Tipy
- Každému nástroju dajte vlastný token, aby ste jeden mohli odobrať bez toho, aby ste pokazili ostatné.
- Vyberte najmenšie časové okno údajov, ktoré stačí.
- Pre externistov a jednorazové zákazky nastavte dátum vypršania.
- Token, ktorý v stĺpci Naposledy použité dlho ukazuje Nikdy, pravdepodobne nepotrebujete. Odstráňte ho.
- Ak chcete, aby Storeep sám posielal udalosti objednávok na váš server namiesto toho, aby sa server pýtal, použite webhooky.