Ga naar hoofdinhoud

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.

Overzicht

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 API-key aanmaken.
  3. 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.
  4. 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.

VriendenLoterij VIP-kaart​

Wil je VriendenLoterij-VIP-kaarthouders kaarten laten boeken, dan zet je de koppeling hier aan: maak een API-key aan met als Applicatie VriendenLoterij VIP-kaart en laat met het ververs-icoon een willekeurige sleutel maken. VoordeMensen logt bij de VriendenLoterij in met een eigen account, dus die waarde volstaat. Alleen als de VriendenLoterij jouw theater eigen inloggegevens gaf, vul je die in als gebruikersnaam:key. Zolang de regel actief is, kun je een kaartsoort als VriendenLoterij VIP markeren (kaartsoort bewerken, tab Geavanceerd). Zet je de regel uit, dan biedt de ticketshop die kaartsoort niet meer 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