Help›Een API-sleutel aanmaken
Een API-sleutel aanmaken
Een sleutel voor je eigen software: aanmaken, veilig bewaren, testen, vernieuwen en intrekken.
Met een API-sleutel werkt je eigen software met de gegevens van je sites, bijvoorbeeld je vacatures uit je personeelsprogramma. De sleutel is een wachtwoord voor software, met de rechten die jij kiest. Een AI-assistent heeft geen sleutel nodig: die verbindt via de MCP, met jouw account. Zie Je site bewerken met je AI-assistent.
Voor je begint
Wie: de eigenaar of een beheerder van de organisatie. Een redacteur, designer of lid ziet de API-sleutels niet.
Formule: elke formule.
Nodig: weten welke koppeling de sleutel krijgt en wat ze moet kunnen, en een veilige plaats om hem te bewaren, zoals een wachtwoordmanager.
Een sleutel aanmaken
Meld aan op app.kintsu.be en ga naar Organisatie › Instellingen › API-sleutels.
Vul bij Naam in waarvoor de sleutel dient, bijvoorbeeld “Koppeling boekhouding”. Zo weet je later wat hem gebruikt.
Vink bij Rechten enkel aan wat de koppeling nodig heeft. Zie hieronder.
Kies bij Geldig een termijn: 30 dagen, 90 dagen (standaard), 365 dagen of Zonder einddatum. Kies liefst 90 of 365 dagen.
Klik op Sleutel aanmaken. Meldde je een tijd geleden aan, dan vraagt Kintsu eerst je wachtwoord in Bevestig dat jij het bent.
Je ziet: “Kopieer de sleutel nu: je ziet hem maar één keer.” Klik op Kopiëren.
Bewaar de sleutel meteen op een veilige plaats.
Let op: Kintsu bewaart de sleutel zelf niet, enkel een onomkeerbare afdruk. Niemand kan hem dus nog tonen. Ben je hem kwijt, maak dan een nieuwe en verwijder de oude.
Welke rechten kies je?
Je ziet enkel de rechten die je rol zelf heeft: een sleutel krijgt nooit meer dan jij. De API gebruikt er vier:
site.read: je sites, tabellen en items lezen.
content.edit: items maken, wijzigen en naar de prullenbak sturen, ook veel tegelijk met een eigen id, en bestanden opladen.
content.publish: concepten online zetten.
submission.read: de inzendingen van je formulieren lezen.
De andere rechten in de lijst, zoals domain.manage, gebruikt de API vandaag niet. Laat ze uit. Kies altijd het minimum: een koppeling die enkel je vacatures toont, heeft genoeg aan site.read.
De sleutel testen
Zet de sleutel in een omgevingsvariabele en vraag Kintsu voor wie hij werkt. Op macOS of Linux, in de terminal:
export KINTSU_API_KEY="plak-hier-je-sleutel"
curl https://app.kintsu.be/api/v1/whoami -H "Authorization: Bearer $KINTSU_API_KEY"
Op Windows, in PowerShell:
$env:KINTSU_API_KEY = "plak-hier-je-sleutel"
curl.exe https://app.kintsu.be/api/v1/whoami -H "Authorization: Bearer $env:KINTSU_API_KEY"
Het antwoord toont je organisatie, de naam van de sleutel en zijn rechten, bijvoorbeeld:
{"organization": {"id": "…", "name": "Bakkerij Peeters", "slug": "bakkerij-peeters"}, "key": {"id": "…", "name": "Koppeling boekhouding"}, "permissions": {"site": ["read"]}}
Krijg je een fout, kijk dan bij Lukt het niet? onderaan.
Veilig bewaren en delen
Bewaar de sleutel in een wachtwoordmanager, of in de geheimen van je server (een omgevingsvariabele of een kluis). Nooit in de code van een website of app, en nooit in Git.
Gebruik hem enkel op een server, nooit in een browser of een app op een gsm: daar kan iedereen hem lezen.
Stuur hem nooit per mail, chat of schermafbeelding. Geef hem aan een ontwikkelaar via een wachtwoordmanager of een eenmalige link.
Maak per koppeling of per ontwikkelaar een eigen sleutel. Dan trek je er één in zonder de andere te storen.
Wanneer stopt een sleutel?
Een sleutel werkt voor wie hem aanmaakte, met hoogstens de rechten die die persoon op dat moment heeft. Hij stopt meteen als:
zijn termijn voorbij is (de lijst toont dan Verlopen);
iemand hem verwijdert;
de maker de organisatie verlaat of eruit verwijderd wordt;
de rol van de maker tweestapsverificatie vraagt en die uit staat.
Krijgt de maker een lagere rol, dan verliest de sleutel de rechten die die rol niet heeft. Maak sleutels voor blijvende koppelingen dus aan met een account dat blijft, zoals dat van de zaakvoerder.
Nakijken
Bij Sleutels van de organisatie zie je per sleutel de naam, het begin van de sleutel, de rechten, wie hem aanmaakte en wanneer, tot wanneer hij geldt en wanneer hij laatst gebruikt werd. Verwijder wat je niet meer gebruikt. Een organisatie heeft hoogstens 50 sleutels.
Vernieuwen zonder onderbreking
Er is geen knop om een sleutel te vernieuwen. Zo doe je het, ruim voor de oude verloopt:
Maak een nieuwe sleutel met dezelfde rechten.
Zet de nieuwe sleutel in je koppeling.
Test met whoami en kijk na dat je koppeling werkt. In de lijst zie je bij de nieuwe sleutel wanneer hij laatst gebruikt werd.
Verwijder de oude sleutel.
Intrekken
Klik op Verwijderen bij de sleutel. Hij stopt meteen: software die hem gebruikt, krijgt vanaf dan een fout 401.
Uitgelekt?
Stond de sleutel in een mail, een chat, een schermafbeelding of in code op GitHub?
Verwijder hem meteen, ook als je niet zeker bent dat iemand hem zag.
Maak een nieuwe sleutel en zet die in je koppeling.
Kijk na wat er gebeurde: in Organisatie › Instellingen › Auditlog, en in de Geschiedenis van de editor. Wijzigingen met een sleutel staan daar met “via de API”.
Draai terug wat niet klopt, of zet een vorige publicatie terug. Zie Publiceren en terugdraaien.
Lukt het niet?
401 met de code API_KEY_INVALID: de sleutel ontbreekt, is fout, verlopen of verwijderd, of de maker is geen lid meer. Kijk ook na dat de header precies Authorization: Bearer is, gevolgd door de sleutel.
403 met de code forbidden: de sleutel mist het recht voor dit verzoek. Maak een nieuwe met het juiste recht.
403 met de code API_ORGANIZATION_SUSPENDED: de organisatie is geschorst.
403 met de code READ_ONLY: het abonnement is achterstallig of beëindigd. Lezen kan nog, wijzigen niet. De eigenaar regelt het onder Abonnement.
429 met de code API_RATE_LIMITED: meer dan 120 verzoeken per minuut met deze sleutel. Wacht het aantal seconden uit de header Retry-After.
“Je rol heeft geen rechten van de app om aan een sleutel te geven.” Vraag het aan de eigenaar.
“Een organisatie heeft hoogstens 50 API-sleutels.” Verwijder sleutels die je niet meer gebruikt.
Met je AI-assistent
Een assistent maakt geen sleutels, en geef hem er ook geen in een gesprek. Vraag hem wel om een script: “Schrijf een script dat mijn vacatures uit Kintsu ophaalt met de API. Lees de sleutel uit de omgevingsvariabele KINTSU_API_KEY.”
Meer over de API: De API voor ontwikkelaars en de referentie.
Nagekeken op 4 november 2026.