K čemu jsou přístupové tokeny
Přístupový token (také klíč API) umožňuje vašemu vlastnímu softwaru, vývojáři nebo nástroji třetí strany číst data z obchodu přes Storeep API. Každý token má vlastní oprávnění, datové okno a datum vypršení, takže každému nástroji dáte přesně to, co potřebuje, a kdykoli ho odeberete, aniž byste sdíleli heslo.
Otevřete Nastavení > Přístupové tokeny. Tlačítko Zobrazit dokumentaci otevře referenci API s endpointy, způsobem odeslání tokenu a limity požadavků. Tuto stránku předejte svému vývojáři.
Chcete místo toho připojit AI asistenta, jako je Claude nebo ChatGPT? K tomu se přístupové tokeny nepoužívají. Viz Připojení AI asistenta.
Vytvoření tokenu
Klikněte na Vytvořit nový token, vyplňte formulář a klikněte na Vytvořit.
- Název tokenu: označení, podle kterého ho poznáte v seznamu, například "Synchronizace účetnictví". Vidíte ho jen vy.
- Oprávnění: zaškrtněte alespoň jedno:
- Čtení produktů: seznamy produktů, detaily, varianty a sklad.
- Čtení objednávek: historie objednávek, detaily, stavy a položky.
- Čtení webhooků: zobrazení konfigurace webhooků a protokolů doručení.
- Správa webhooků: vytváření, úprava a mazání odběrů webhooků přes API.
- Přístup k datům: jak daleko do minulosti smí token číst.
- Posledních 24 hodin: jen data vytvořená za posledních 24 hodin. Nejbezpečnější volba, vhodná pro živou synchronizaci.
- Nastavit datum začátku: jen data vytvořená v den, který vyberete v poli Datum začátku přístupu k datům, nebo později.
- Celá doba: všechna vaše data bez časového omezení.
- Vypršení platnosti: Nikdy nevyprší, nebo Nastavit datum vypršení platnosti a vybrat datum až rok dopředu. Po tomto datu token sám přestane fungovat.
Zkopírujte token hned
Po kliknutí na Vytvořit okno ukáže Váš přístupový token s tlačítkem kopírování. Tento token se zobrazí jen jednou. Zkopírujte ho a uložte na bezpečné místo, například do správce hesel. Storeep ho znovu zobrazit nemůže. Pokud ho ztratíte, token smažte a vytvořte nový.
Zacházejte s ním jako s heslem. Nikdy ho nevkládejte do kódu webu, veřejných repozitářů, snímků obrazovky ani zpráv v chatu.
Seznam tokenů
- Jméno s datem vytvoření.
- Oprávnění: například Čtení produktů nebo Čtení objednávek.
- Přístup k datům: Posledních 24 hodin, Všechna data nebo Od určitého data.
- Vypršení platnosti: datum, nebo Nikdy.
- Naposledy použito: kdy token naposledy použil nějaký nástroj, nebo Nikdy.
Počet tokenů na obchod je omezený. Když limitu dosáhnete, tlačítko Vytvořit nový token zmizí, dokud nějaký token nesmažete.
Úprava tokenu
Kliknutím na token změníte jeho název, oprávnění, přístup k datům nebo vypršení. Hodnota tokenu zůstane stejná, takže nástroj, který ho používá, funguje dál s novými pravidly.
Smazání tokenu
Zaškrtněte jeden nebo více tokenů a zvolte Smazat tokeny, nebo použijte tlačítko koše v řádku. Token okamžitě přestane fungovat a každý nástroj, který ho používá, dostane chybu.
Tipy
- Každému nástroji dejte vlastní token, abyste mohli jeden odebrat, aniž byste rozbili ostatní.
- Zvolte nejmenší datové okno, které stačí.
- Pro externisty a jednorázové zakázky nastavte datum vypršení.
- Token, který má dlouho ve sloupci Naposledy použito hodnotu Nikdy, pravděpodobně nepotřebujete. Smažte ho.
- Pokud chcete, aby Storeep sám posílal události objednávek na váš server, místo aby se váš server ptal, použijte webhooky.