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
- Ga naar Koppelingen → API keys.
- Klik op API-key aanmaken.
- Vul in:
- Applicatie - kies de koppeling uit de lijst, of maak een nieuwe naam aan (Nieuwe applicatie). Kies per integratie een eigen naam; een naam kan maar één keer voorkomen.
- API-key - klik op het ververs-icoon in het veld om een willekeurige sleutel te laten maken, of vul zelf een sterke sleutel in.
- Actief - staat standaard aan; dan is de sleutel direct geldig.
- Klik Aanmaken.
In de lijst kopieer je een sleutel door erop te klikken, en zet je hem met het pauze/play-icoon uit of weer aan.
Sleutels voor een AI-assistent maak je niet hier, maar onder Agent-toegang; die staan ook niet in deze lijst.
Beveiliging
- Geef elke integratie een eigen key - zo kun je ze los intrekken.
- Deactiveer een key met het pauze-icoon in de lijst (of 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