API-keys

Als je een externe dienst of ontwikkelaar toegang wilt geven tot jouw data (events, bestellingen, bezoekers) via onze API, maak je een API-key aan.

Wanneer gebruik je dit

• Je koppelt een eigen website of app aan VdM (bijv. een custom agenda).
• Je geeft een development-partner tijdelijk toegang.
• Je integreert met een externe dienst die geen voorgebakken koppeling heeft.

Stappen - nieuwe API-key aanmaken

1. Ga naar Koppelingen → API-Keys.
2. Klik op Nieuw.
3. Vul in:
   • Gebruikersnaam - unieke identifier (kies per integratie een eigen naam)
   • Wachtwoord - sterk, random gegenereerd
   • Actief - aanvinken om direct geldig te maken
4. Klik Maken.

Beveiliging

• Geef elke integratie een eigen key - zo kun je ze los intrekken.
• Deactiveer een key door Actief uit te zetten - geen verwijderen nodig.
• Verwijder keys die niet meer gebruikt worden.
• Deel keys alleen via een veilig kanaal (niet in e-mail of chat onversleuteld).

Wat kan een API-key?

Een API-key geeft toegang tot twee API-oppervlaktes:

• Publieke API - webshop-achtige endpoints (events, ticket-types, cart, order) voor je eigen site-integraties. Zie Public endpoints.
• Peppered API - uitgebreidere endpoints voor CRM/BI-koppelingen (klanten, orders, exports, wachtlijst, plattegronden, betaalmethoden). Zie Peppered endpoints.

Authenticatie: geef de key mee in de Authorization-header als raw value, zonder Bearer-prefix. Volledige details, voorbeelden en een Bruno-collectie staan in de API-overzicht en OpenAPI spec.

---

Zie ook: Webhooks · API-overzicht