🔌 API-tokens
In 30 seconden
- Met een token kunnen Make, Zapier of je eigen scripts gegevens in de werkplaats lezen of schrijven zonder dat er iemand achter het scherm zit.
- Het zit in de abonnementen Max en Business, en wordt aangemaakt door beheerders en eigenaren.
- De sleutel zie je maar één keer, bij het aanmaken: kopieer hem meteen.
- Geef het token de laagste rol die het nodig heeft, en deactiveer het als je het niet meer gebruikt.
Met API-tokens koppel je BolloPrint aan externe tools zoals Make (Integromat), Zapier, je eigen scripts of elk ander systeem dat gegevens in de werkplaats moet lezen of schrijven zonder dat er iemand bij is.
Je vindt ze onder Instellingen → Extensies → API-tokens, voor beheerders en eigenaren.
De API zit in de abonnementen Max en Business. Zit hij niet in jouw abonnement, dan is de sectie vergrendeld en worden aanroepen met een token geweigerd, ook als het token bestaat.
Wat kan een koppeling met een API-token doen?
Afhankelijk van de rol die je aan het token geeft, kan een koppeling:
- Automatisch bestellingen aanmaken wanneer er een verkoop van een ander platform binnenkomt.
- De status van bestellingen lezen om een extern volgsysteem bij te werken.
- Klanten in bulk toevoegen vanuit een import.
- De materiaalvoorraad opvragen voor voorraadmeldingen.
Het token handelt namens een “systeem”-gebruiker van de werkplaats, niet namens een bepaalde persoon.
Een API-token aanmaken
- Ga naar Instellingen → Extensies → API-tokens.
- Klik op “Token aanmaken”.
- Vul het formulier in:
- Naam: iets beschrijvends, zodat je weet waarvoor het dient (bijv. “Make — webbestellingen”).
- Rol: het toegangsniveau van het token (Beheerder, Medewerker of Alleen lezen). Gebruik het minimum dat nodig is.
- Vervaldatum: hoe lang het token actief blijft (1 week, 1 maand, 3 maanden, 1 jaar of Verloopt niet).
- Klik op Token aanmaken.
🔐 Het token wordt maar één keer getoond
Direct na het aanmaken toont het systeem de volledige sleutel. Kopieer hem meteen — je kunt hem daarna niet meer bekijken. Ben je hem kwijt, dan moet je een nieuw token aanmaken en het oude deactiveren.
Het token begint met bp_tat_
Alle werkplaatstokens beginnen met het voorvoegsel bp_tat_ (BolloPrint Tenant API Token). Zo herken je ze makkelijk als je meerdere tokens in een wachtwoordmanager bewaart.
Rollen van het token
| Rol | Wat het kan |
|---|---|
| Beheerder | Volledige toegang (lezen en schrijven in alle modules). |
| Medewerker | Hetzelfde als iemand met de rol Medewerker: beheert bestellingen, klanten en de catalogus. |
| Alleen lezen | Alleen raadplegen, wijzigt niets. Handig voor koppelingen die alleen gegevens hoeven op te vragen. |
Een token deactiveren
Heb je een token niet meer nodig, maar wil je de geschiedenis van wat het deed bewaren, gebruik dan Deactiveren. Het token werkt dan niet meer, maar blijft in de lijst staan.
Wil je het helemaal uit de lijst halen, gebruik dan Verwijderen (alleen beschikbaar voor tokens die al gedeactiveerd of verlopen zijn).
Gebruik bijhouden
Telkens wanneer een koppeling de API met een token aanroept, legt BolloPrint de actie vast in de geschiedenis van de bestelling of offerte die wordt gewijzigd. In plaats van de naam van een persoon zie je als auteur de naam van het token.
Wie kan API-tokens beheren?
Alleen beheerders en eigenaren kunnen tokens aanmaken, bekijken en deactiveren. Medewerkers en gebruikers met Alleen lezen hebben geen toegang tot deze sectie.