Hoe gebruik ik de Tickable API?
Tickable heeft een API waarmee je evenementen, bestellingen, tickets en webhooks programmatisch kunt benaderen. Handig
als je Tickable wilt koppelen aan je eigen website, CRM, boekhoudsoftware of andere systemen.
De volledige technische documentatie vind je op docs.tickable.io.
Wat kun je met de API?
Via de API kun je onder andere je evenementen en tijdsloten ophalen, bestellingen en tickets inzien, tickets scannen
vanuit je eigen systeem, en webhooks instellen zodat je automatisch een melding ontvangt wanneer er een bestelling wordt
geplaatst of een ticket wordt gescand.
Hoe begin ik?
Om aan de slag te gaan heb je een API-sleutel nodig. Die maak je aan in het Tickable-dashboard via Instellingen →
Ontwikkelaars (app.tickable.nl/settings/developers). Bij het aanmaken kies je welke rechten (scopes) de sleutel krijgt,
bijvoorbeeld events.read om evenementen op te halen, of tickets.read om tickets te bekijken.
Elke API-aanroep bevat je sleutel als Bearer-token in de Authorization-header. Een voorbeeld:
curl https://api.tickable.io/events \
-H "Authorization: Bearer tk_live_JOUW_API_SLEUTEL"
Binnen twee minuten kun je zo je eerste evenementen ophalen.
Authenticatie
Er zijn twee manieren om te authenticeren:
- API-sleutel — ideaal voor directe server-naar-server koppelingen, zoals een synchronisatie met je eigen database of
boekhouding.
- OAuth2 — bedoeld voor situaties waarin een externe applicatie namens een Tickable-gebruiker toegang nodig heeft,
bijvoorbeeld een integratie die je voor meerdere organisaties aanbiedt.
De meeste organisaties komen prima uit met een API-sleutel.
Beschikbare rechten (scopes)
Bij het aanmaken van een API-sleutel kies je precies welke data de sleutel mag benaderen:
- events.read — Evenementen, tickettypes en tijdsloten ophalen
- events.write — Evenementen aanmaken en bijwerken
- orders.read — Bestellingen inzien
- tickets.read — Tickets ophalen
- tickets.write — Tickets scannen
- webhooks.read — Webhooks bekijken
- webhooks.write — Webhooks aanmaken en verwijderen
Webhooks
Met webhooks ontvang je realtime meldingen wanneer er iets gebeurt — bijvoorbeeld bij een nieuwe bestelling
(order.confirmed) of een gescand ticket. Zo hoef je niet zelf periodiek te controleren of er iets is veranderd.
Meer informatie
De volledige API-referentie, voorbeelden in cURL, Node.js en Python, en uitleg over paginering en webhooks vind je in de
developer-documentatie: docs.tickable.io.
Loop je ergens tegenaan? Neem dan contact met ons op via tickable.nl.
