🔌 API tokeny
Za 30 sekund
- Token umožňuje, aby Make, Zapier nebo vaše vlastní skripty četly nebo zapisovaly data v dílně, aniž by u toho musel sedět člověk.
- Je součástí tarifů Max a Business a vytvářejí ho administrátoři a vlastníci.
- Klíč se zobrazí jen jednou, při vytvoření: zkopírujte si ho hned.
- Přidělte tokenu nejnižší roli, kterou potřebuje, a deaktivujte ho, jakmile ho přestanete používat.
API tokeny umožňují propojit BolloPrint s externími nástroji, jako je Make (Integromat), Zapier, vlastní skripty nebo jakýkoli systém, který potřebuje číst nebo zapisovat data dílny bez přítomnosti člověka.
Najdete je v Nastavení → Rozšíření → API tokeny; přístup k nim mají administrátoři a vlastníci.
API je součástí tarifů Max a Business. Pokud ho váš tarif nezahrnuje, sekce se zobrazí jako uzamčená a volání s tokenem se odmítají, i když token existuje.
Co může integrace s API tokenem dělat?
Podle role, kterou tokenu přidělíte, může integrace:
- Automaticky vytvářet objednávky, když přijde prodej z jiné platformy.
- Číst stav objednávek a aktualizovat podle něj externí systém sledování.
- Hromadně přidávat zákazníky z importu.
- Zjišťovat stav skladu materiálu kvůli upozorněním na docházející zásoby.
Token jedná jménem „systémového“ uživatele dílny, nikoli konkrétní osoby.
Vytvoření API tokenu
- Přejděte do Nastavení → Rozšíření → API tokeny.
- Klikněte na „Vytvořit token“.
- Vyplňte formulář:
- Název: něco výstižného, z čeho se pozná, k čemu token slouží (např. „Make — webové objednávky“).
- Role: úroveň přístupu tokenu (Admin, Pracovník nebo Jen pro čtení). Použijte nejnižší potřebnou.
- Platnost do: jak dlouho bude token aktivní (1 týden, 1 měsíc, 3 měsíce, 1 rok nebo Bez vypršení).
- Klikněte na Vytvořit token.
🔐 Token se zobrazí jen jednou
Ihned po vytvoření tokenu systém zobrazí celý klíč. Zkopírujte si ho hned — znovu už ho zobrazit nelze. Pokud ho ztratíte, budete muset vytvořit nový token a ten starý deaktivovat.
Token začíná na bp_tat_
Všechny tokeny dílny začínají předponou bp_tat_ (BolloPrint Tenant API Token). Snadno ho tak poznáte, pokud máte ve správci hesel uloženo více tokenů.
Role tokenu
| Role | Co může dělat |
|---|---|
| Admin | Plný přístup (čtení i zápis ve všech modulech). |
| Pracovník | Totéž co člověk s rolí Pracovník: spravuje objednávky, zákazníky a katalog. |
| Jen pro čtení | Jen nahlíží, nic nemění. Hodí se pro integrace, které potřebují data pouze číst. |
Deaktivace tokenu
Pokud token už nepotřebujete, ale chcete si ponechat historii toho, co dělal, použijte Deaktivovat. Token přestane fungovat, ale zůstane v seznamu.
Pokud ho chcete ze seznamu úplně odstranit, použijte Smazat (k dispozici jen u tokenů, které jsou už deaktivované nebo jejichž platnost vypršela).
Záznam použití
Pokaždé, když integrace zavolá API pomocí tokenu, BolloPrint zaznamená akci do historie objednávky nebo nabídky, kterou mění. Místo jména osoby uvidíte jako autora název tokenu.
Kdo může spravovat API tokeny?
Vytvářet, zobrazovat a deaktivovat tokeny mohou jen administrátoři a vlastníci. Pracovníci a uživatelé s rolí Jen pro čtení do této sekce přístup nemají.