🔌 Token API
I token API permettono di collegare BolloPrint a strumenti esterni come Make (Integromat), Zapier, script propri o qualsiasi sistema che debba leggere o scrivere dati nel laboratorio senza che ci sia una persona davanti.
Sono disponibili in Impostazioni → Estensioni → Token API per Admin e Proprietari.
L'API è inclusa nei piani Max e Business. Se il tuo piano non la include, la sezione appare bloccata e le chiamate con token vengono rifiutate anche se il token esiste.
Cosa può fare un'integrazione con un token API?
A seconda del ruolo che assegni al token, un'integrazione può:
- Creare ordini automaticamente quando arriva una vendita da un'altra piattaforma.
- Leggere lo stato degli ordini per aggiornare un sistema esterno di tracciamento.
- Aggiungere clienti in blocco da un'importazione.
- Consultare l'inventario per gli avvisi di stock.
Il token agisce a nome di un utente "di sistema" del laboratorio, non di una persona specifica.
Creare un token API
- Vai su Impostazioni → Estensioni → Token API.
- Premi "Crea token".
- Compila il modulo:
- Nome: qualcosa di descrittivo per sapere a cosa serve (p.es. "Make — ordini web").
- Ruolo: il livello di accesso del token (
admin,workeroviewer). Usa il minimo necessario. - Scadenza: per quanto tempo resterà attivo il token (1 settimana, 1 mese, 3 mesi, 1 anno, o senza scadenza).
- Premi Crea token.
🔐 Il token si vede una volta sola
Subito dopo aver creato il token, il sistema mostra la chiave completa. Copiala in quel momento — non si può vedere di nuovo. Se la perdi, dovrai creare un nuovo token e revocare il precedente.
Il token inizia con bp_tat_
Tutti i token di laboratorio iniziano con il prefisso bp_tat_ (BolloPrint Tenant API Token). È facile da riconoscere se hai diversi token in un gestore di password.
Ruoli del token
| Ruolo | Cosa può fare |
|---|---|
admin | Accesso completo (lettura e scrittura su tutti i moduli). |
worker | Equivalente a un Lavoratore: gestisce ordini, clienti, catalogo. |
viewer | Sola lettura. Utile per integrazioni che devono solo consultare i dati. |
Disattivare un token
Se un token non ti serve più ma vuoi conservare lo storico di ciò che ha fatto, usa Disattiva. Il token smette di funzionare ma resta nell'elenco.
Se vuoi eliminarlo completamente dall'elenco, usa Elimina (disponibile solo per i token già disattivati o scaduti).
Audit di utilizzo
Ogni volta che un'integrazione chiama l'API usando un token, BolloPrint registra l'azione nella cronologia dell'ordine o del preventivo che modifica. Al posto del nome di una persona, come autore vedrai "API".
Chi può gestire i token API?
Solo Admin e Proprietari possono creare, vedere e revocare token. I Lavoratori e i Sola lettura non hanno accesso a questa sezione.