Weeztix API koppelen aan je website.

Weeztix is een ticketsysteem voor evenementen. De naam is nieuw: het heette tot voor kort Eventix, en die wisseling is nog goed te zien in wat mensen intypen: het zoekvolume op de oude naam loopt terug terwijl dat op de nieuwe stijgt.

In het systeem maak je locaties, evenementen en datums aan, daarna de tickets die daarbij horen, en vervolgens een of meer shops om die tickets in te verkopen. Daaromheen zitten bestellingen en reserveringen, doorverkoop met barcodevalidatie, webhooks en een wachtlijst.

Voor een website gaat het om het laatste stuk van die keten: waar iemand je evenement vindt, en waar hij afrekent. Dat hoeft niet dezelfde plek te zijn als waar jij het evenement beheert.

Via hun REST-API, en die begint met toestemming. Je registreert een client, stuurt de gebruiker naar de OAuth2-server van Weeztix, hij geeft akkoord, en met de code die terugkomt haal je een access token op. Dat token gaat mee bij elke aanroep en wordt met een refresh token vernieuwd.

Daarna halen we de evenementen, datums en tickets op en bewaren die aan onze kant, zodat de pagina snel is. Per evenement bouwen we een eigen pagina: jouw tekst, jouw beeld, het programma, en de tickets die er op dat moment bij horen.

Voor de verkoop zelf zijn er twee wegen. De ticketshop van Weeztix is als iframe in een pagina te zetten met een stuk code dat je uit hun dashboard haalt; dat werkt ook in een WordPress-blok. Of je bouwt de bestelstroom zelf op de API, met reserveringen en bestellingen. Wat verstandig is hangt af van hoeveel je aan de afrekenstap wilt veranderen.

Het begint in het dashboard van Weeztix. Onder Company settings en OAuth Clients registreer je de koppeling als client, met een naam en een redirect URL: het adres waar de gebruiker na zijn akkoord op terugkomt. Je krijgt dan een identifier en een secret.

Dat secret hoort nooit in de browser of in een repository. Weeztix trekt bij een gelekt secret alle tokens van die client in, en schrijft er zelf bij dat een koppeling die alleen in JavaScript draait, zonder server, daarom niet kan.

Daarna de toestemming. De gebruiker gaat naar login.weeztix.com, geeft akkoord, en met de code die terugkomt vraag je het access token op. Dat token is standaard 3 dagen geldig, het refresh token 365 dagen.

Een apart testtoken bestaat nog niet, dus testen gaat met de echte OAuth-stroom. Pas als de pagina’s, de shop en de trackers kloppen, gaat de koppeling live.

Meer dan tickets tonen. De documentatie beschrijft locaties, evenementen en eventdatums, tickets en het koppelen daarvan aan datums, shops met de tickets die erin hangen, trackers voor het meten van verkeer, bestellingen en reserveringen, doorverkoop met barcodevalidatie en het omwisselen van tickets, webhooks, en een wachtlijst met aanmeldingen.

Dat betekent dat een koppeling verder kan gaan dan een verkooppagina. Een wachtlijst op je eigen site als een event is uitverkocht, een webhook die je site bijwerkt zodra er iets verandert, of een eigen overzicht van wat er nog vrij is: het staat er allemaal in.

Wat er niet in staat is de meerdaagse variant. Weeztix houdt de openbare documentatie bewust bij evenementen op één dag en verwijst voor de rest naar hun API-team. Dat is geen beperking van het systeem maar wel van wat je vooraf kunt nalezen.

Weeztix noemt geen limiet op het aantal aanroepen, wel op het aantal tokens. Per gebruiker en per client kan er maar een beperkt aantal bestaan. Is die grens bereikt, dan vervalt het token dat het langst niet is gebruikt.

Bij webhooks staan er twee soorten in de documentatie. Die in de API-referentie worden niet meer onderhouden; de nieuwe wel, maar die zijn nog niet af. Geeft je server een 4xx terug, dan geldt de aanroep als mislukt en probeert Weeztix het opnieuw, tot standaard 3 pogingen, met steeds twee keer zo lang ertussen. Elke aanroep draagt de nonce van de webhook in de header OpenTicket-Identifier, en daarmee controleer je dat het bericht echt van Weeztix komt.

Adverteer je op Meta: de koppeling van Weeztix met de Conversions API werkt alleen als de fbclid aanwezig is op de pagina die naar je shop verwijst. Hoe we dat bewaken staat bij Data & Tracking.

Werk je als podium of theater, dan ligt de Stager API meer voor de hand.

De iframe is snel klaar. Je haalt de code uit je dashboard, plakt hem in een pagina en de shop staat er, met je eigen kleuren en een eigen achtergrond.

Het verschil zit in wat er van je evenement overblijft voor iemand die het nog niet kent. Wat in een iframe staat komt niet in de HTML van je eigen pagina: geen eigen adres per evenement, geen eigen omschrijving, geen gestructureerde data die Google als evenement herkent. Je hebt dan één pagina met een kader erop, en de evenementen erin bestaan voor een zoekmachine niet.

Met een integratie bouwen we per evenement een echte pagina: eigen titel, eigen tekst, het programma, de datum en de locatie, en daaronder de verkoop. Die pagina kun je delen, erop adverteren en ernaar linken. Weeztix blijft het systeem waarin je de tickets beheert en de bestellingen binnenkomen.