API Keys

API keys geven je programmatische toegang tot je Bigmind data. Je hebt een API key nodig om Bigmind te integreren met je applicaties, geautomatiseerde scripts uit te voeren of custom integraties te bouwen.

#Wat zijn API keys?

Een API key is een unieke identifier die je applicatie authenticeert bij het maken van verzoeken naar de Bigmind API. Zie het als een wachtwoord—het bewijst dat je toestemming hebt om programmatisch toegang te krijgen tot de data van je organisatie.

#Je eerste API key aanmaken

Zo genereer je een API key:

1. Ga naar Instellingen — Klik op je avatar rechtsboven en selecteer "Instellingen"
2. Ga naar API Keys — Zoek en klik op "API Keys" in de instellingen zijbalk
3. Maak een nieuwe key aan — Klik op de knop "API key aanmaken" rechtsboven
4. Geef je key een naam (optioneel) — Geef je key een beschrijvende naam zoals "Productie API" of "Ontwikkel Key" om hem later te kunnen identificeren
5. Klik op Aanmaken — Je nieuwe API key wordt gegenereerd

#Je API key kopiëren

Dit is belangrijk: Wanneer je API key is aangemaakt, zie je deze slechts één keer weergegeven. Zodra je dit dialoogvenster sluit, kun je de volledige key niet meer zien.

Om je key op te slaan:

1. Klik op de knop "Kopiëren" naast je API key
2. Sla hem veilig op (zoals in een wachtwoordmanager of omgevingsvariabelen)
3. Klik op "Ik heb de key gekopieerd" zodra je hem hebt opgeslagen

#Beveiligingsbest practices

Je API keys hebben volledige toegang tot de data van je organisatie. Houd ze veilig:

• Deel API keys nooit publiekelijk — Commit ze niet naar Git repositories en deel ze niet in chatberichten
• Gebruik omgevingsvariabelen — Sla keys op in omgevingsvariabelen, niet in je code
• Roteer keys regelmatig — Verwijder oude keys en maak periodiek nieuwe aan
• Gebruik aparte keys per omgeving — Maak verschillende keys aan voor ontwikkeling, staging en productie
• Verwijder ongebruikte keys — Als je een key niet meer gebruikt, verwijder hem dan onmiddellijk

#Je API key gebruiken

Voeg je API key toe aan de Authorization header van je API verzoeken:

Authorization: Bearer sk_your_api_key_here

Bijvoorbeeld, met curl:

curl https://api.bigmind.com/v1/meetings \
  -H "Authorization: Bearer sk_your_api_key_here"

#API keys beheren

Je kunt al je API keys zien op de pagina Instellingen > API Keys. Elke key toont:

• Naam — De beschrijvende naam die je eraan hebt gegeven
• Key preview — Een gemaskeerde versie van de key (sk_••••••••••••••••••••••••••••••••)
• Aanmaakdatum — Wanneer de key is gegenereerd
• Laatst gewijzigd — Wanneer de key voor het laatst is aangepast

#Een API key verwijderen

Als je toegang moet intrekken of een ongebruikte key wilt verwijderen:

1. Zweef over de API key in de tabel
2. Klik op de knop "Verwijderen" die verschijnt
3. Bevestig het verwijderen

Waarschuwing: Zodra je een API key verwijdert, zullen alle applicaties die deze key gebruiken onmiddellijk stoppen met werken. Deze actie kan niet ongedaan worden gemaakt.

#Wat te doen als je key gecompromitteerd is

Als je per ongeluk je API key hebt blootgesteld of vermoedt dat deze gecompromitteerd is:

1. Verwijder de gecompromitteerde key onmiddellijk — Ga naar Instellingen > API Keys en verwijder hem
2. Maak een nieuwe key aan — Genereer een vervangende key met een nieuwe naam
3. Update je applicaties — Vervang de oude key door de nieuwe in je code
4. Monitor op ongebruikelijke activiteit — Controleer je API gebruikslogs op verdachte verzoeken

#Hulp nodig?

Als je problemen hebt met API keys of hulp nodig hebt bij het integreren met de Bigmind API, neem contact op met ons support team of bekijk onze API documentatie.