Wat je nodig hebt
- De rol Admin of Member. Een Viewer ziet de pagina API niet.
- Minstens één koppeling met gegevens. Een sleutel maken kan in elk pakket; de API zelf werkt niet meer als je proefperiode is verlopen of je abonnement niet actief is.
Een sleutel aanmaken
- Open Analyseren > API en kies Nieuwe API-sleutel.
- Vul een herkenbare Naam in, bijvoorbeeld “Power BI-koppeling”.
- Kies hoe lang de sleutel Houdbaar is: 30 dagen, 90 dagen (standaard), 180 dagen of 1 jaar. Kortlevende sleutels zijn veiliger.
- Kies API-sleutel aanmaken.
- Kopieer de sleutel direct met Kopiëren. Je krijgt hem hierna nooit meer te zien, ook niet als Admin. APIboard bewaart alleen een afgeleide waarde, dus een kwijtgeraakte sleutel is niet terug te halen. Maak dan een nieuwe sleutel.
Het venster sluit niet met Esc of door ernaast te klikken, zodat je de sleutel niet per ongeluk kwijtraakt. Een sleutel begint met apib_live_.
In de tabel API-sleutels staat per sleutel de naam, de laatste vier tekens, de status (Actief, Verlopen of Ingetrokken) en tot wanneer hij houdbaar is.
Wat een sleutel mag
Een sleutel kan alle tabellen lezen die de API voor jouw organisatie toont, en alleen lezen. Je kiest dus geen scope per sleutel. Bewaar sleutels daarom als wachtwoorden: niet in browsercode of in een bestand dat je deelt.
Limiet
Je kunt maximaal 10 actieve sleutels per organisatie hebben (“Maximaal 10 actieve sleutels per organisatie.”). Trek eerst een sleutel in als je er meer nodig hebt.
Intrekken en verwijderen
- Intrekken: kies bij een actieve sleutel Meer opties en dan intrekken. Elke tool die de sleutel gebruikt, verliest direct toegang. Dit kun je niet ongedaan maken.
- Verwijderen: alleen bij een ingetrokken sleutel. De sleutel verdwijnt uit het overzicht; aanroepen die ermee zijn gedaan blijven in de cijfers meetellen.
- Een verlopen sleutel werkt niet meer. Maak een nieuwe aan.
Controleren wat er gebeurt
Bovenaan de pagina zie je onder “Deze week” het aantal API-aanroepen en Fouten over de afgelopen 7 dagen, vergeleken met de week ervoor.
Over limieten per minuut en per dag lees je meer in Gebruikslimieten, over foutcodes in Foutafhandeling.
Onze tip: geef elke sleutel een naam die zegt waar hij voor is, en kies een korte houdbaarheid. Dan weet je bij het intrekken meteen welke tool het raakt.
Was dit artikel behulpzaam?