API-sleutels Beheren
Maak, beheer en trek API-sleutels in voor externe integraties. Gebruik ze om te authenticeren met de Bugalou REST API.
Overzicht
API-sleutels laten je Bugalou integreren met externe systemen en aangepaste applicaties. Ze worden gebruikt om verzoeken te authenticeren naar alle Bugalou REST API's — of je nu WhatsApp-templates verstuurt, bestellingen beheert of facturen bijhoudt. Navigeer naar Organisatie-instellingen → API & Integraties.
Een API-sleutel Aanmaken
- Klik op "Create API Key" rechtsboven
- Voer een Name in voor de sleutel (bijv. "Productie API", "Staging Omgeving")
- Klik op "Create Key"
- De volledige sleutel wordt eenmalig getoond in een groene kaart — kopieer hem nu! Klik op "Copy" en daarna "I've Saved My Key"
Belangrijk: De volledige sleutel wordt slechts één keer getoond. Daarna is alleen het prefix (bg_live_••••••••) zichtbaar.
Sleutels Beheren
Elke API-sleutelkaart toont:
- Naam — de naam die je hebt gekozen
- Statusbadge — "Active" (groen) of "Disabled" (grijs)
- Prefix — gemaskeerde sleutel:
bg_live_•••••••• - Aangemaakt — aanmaakdatum
- Laatst gebruikt — wanneer de sleutel voor het laatst is gebruikt
Sleutelacties
- Uitschakelen / Inschakelen — schakel een sleutel tijdelijk uit zonder te verwijderen
- Intrekken — verwijder de sleutel permanent (met bevestigingsdialoog)
Authenticatie
Voeg je API-sleutel toe aan elk verzoek via een van twee methoden:
X-API-Key: bg_live_jouw_sleutel_hier— custom headerAuthorization: Bearer bg_live_jouw_sleutel_hier— Bearer token
Beide methoden werken voor alle API-endpoints.
Beveiligingstips
- Deel je API-sleutel nooit in publieke code-repositories
- Gebruik omgevingsvariabelen om sleutels op te slaan in je applicaties
- Maak aparte sleutels voor productie- en staging-omgevingen
- Schakel sleutels uit of trek ze in als ze niet meer nodig zijn
- Roteer sleutels periodiek — maak een nieuwe, update je integraties, trek de oude in
Beschikbare API's
Zodra je een API-sleutel hebt, kun je de volgende REST API's gebruiken:
- WhatsApp Templates API — verstuur templateberichten programmatisch
- Bestellingen & E-commerce API — beheer bestellingen vanuit webshops en eigen systemen
- Facturatie & Betalingen API — volg facturen, betalingen en financiële data