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

1. Klik op "Create API Key" rechtsboven
2. Voer een Name in voor de sleutel (bijv. "Productie API", "Staging Omgeving")
3. Klik op "Create Key"
4. 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 header
• Authorization: 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