🔌 Tokeny API
W 30 sekund
- Token pozwala, żeby Make, Zapier albo twoje własne skrypty odczytywały lub zapisywały dane w warsztacie bez udziału człowieka.
- Jest dostępny w planach Max i Business, a tworzą go Admini i Właściciele.
- Klucz widać tylko raz, przy tworzeniu: skopiuj go od razu.
- Nadaj tokenowi najniższą rolę, jakiej potrzebuje, i dezaktywuj go, gdy przestaniesz go używać.
Tokeny API pozwalają połączyć BolloPrint z zewnętrznymi narzędziami, takimi jak Make (Integromat), Zapier, własne skrypty czy dowolny system, który musi odczytywać lub zapisywać dane warsztatu bez udziału człowieka.
Znajdziesz je w Ustawienia → Rozszerzenia → Tokeny API — mają do nich dostęp Admini i Właściciele.
API jest dostępne w planach Max i Business. Jeśli twój plan go nie obejmuje, sekcja jest zablokowana, a wywołania z tokenem są odrzucane, nawet jeśli token istnieje.
Co może zrobić integracja z tokenem API?
W zależności od roli, którą przypiszesz tokenowi, integracja może:
- Automatycznie tworzyć zamówienia, gdy przychodzi sprzedaż z innej platformy.
- Odczytywać status zamówień, żeby aktualizować zewnętrzny system śledzenia.
- Dodawać klientów hurtowo z importu.
- Sprawdzać magazyn materiałów, żeby wysyłać alerty o stanie.
Token działa w imieniu „systemowego” użytkownika warsztatu, a nie konkretnej osoby.
Utwórz token API
- Przejdź do Ustawienia → Rozszerzenia → Tokeny API.
- Kliknij „Utwórz token”.
- Wypełnij formularz:
- Nazwa: coś opisowego, żeby było wiadomo, do czego służy (np. „Make — zamówienia ze strony”).
- Rola: poziom dostępu tokenu (Admin, Pracownik lub Tylko odczyt). Wybierz minimalny potrzebny.
- Wygaśnięcie: jak długo token będzie aktywny (1 tydzień, 1 miesiąc, 3 miesiące, 1 rok albo Nie wygasa).
- Kliknij Utwórz token.
🔐 Token jest pokazywany tylko raz
Zaraz po utworzeniu tokenu system wyświetla cały klucz. Skopiuj go od razu — nie da się go zobaczyć ponownie. Jeśli go zgubisz, musisz utworzyć nowy token i dezaktywować poprzedni.
Token zaczyna się od bp_tat_
Wszystkie tokeny warsztatu zaczynają się od prefiksu bp_tat_ (BolloPrint Tenant API Token). Łatwo go rozpoznać, jeśli trzymasz kilka tokenów w menedżerze haseł.
Role tokenu
| Rola | Co może robić |
|---|---|
| Admin | Pełny dostęp (odczyt i zapis we wszystkich modułach). |
| Pracownik | To samo co osoba z rolą Pracownik: obsługuje zamówienia, klientów, katalog. |
| Tylko odczyt | Tylko podgląd, niczego nie zmienia. Przydaje się w integracjach, które muszą jedynie sprawdzać dane. |
Dezaktywuj token
Jeśli token nie jest ci już potrzebny, ale chcesz zachować historię tego, co zrobił, użyj Dezaktywuj. Token przestaje działać, ale zostaje na liście.
Jeśli chcesz całkowicie usunąć go z listy, użyj Usuń (dostępne tylko dla tokenów już dezaktywowanych lub wygasłych).
Audyt użycia
Za każdym razem, gdy integracja wywołuje API za pomocą tokenu, BolloPrint zapisuje tę akcję w historii zamówienia lub wyceny, które zmienia. Zamiast imienia osoby jako autora zobaczysz nazwę tokenu.
Kto może zarządzać tokenami API?
Tylko Admini i Właściciele mogą tworzyć, przeglądać i dezaktywować tokeny. Pracownicy i użytkownicy z rolą Tylko odczyt nie mają dostępu do tej sekcji.