KoppelingenWeeztix
Weeztix API koppelen aan je website.
Weeztix, tot voor kort Eventix, is het ticketsysteem waarmee organisatoren hun evenementen verkopen. Wij zetten die events als eigen pagina’s op je site en laten de ticketverkoop daar plaatsvinden, in plaats van in een kader dat bij de leverancier hangt.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Weeztix je oplevert.
Een eigen pagina per event. Elk evenement krijgt een eigen adres op je domein, met je eigen tekst, beeld en programma.
Verkoop op je eigen site. De shop en de tickets komen uit Weeztix, maar de bezoeker blijft op jouw pagina.
Meten wat verkoopt. Met trackers is te zien welke pagina of campagne de tickets oplevert, niet alleen dat ze verkocht zijn.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- REST, beschreven in OpenAPI. Daarnaast een ticketshop die je als iframe in je pagina zet
- Authenticatie
- OAuth2 met de authorization code grant: de gebruiker geeft toestemming, daarna werk je met een access token en een refresh token
- Richting
- Beide kanten op
- Verversing
- Bij het opvragen; wijzigingen komen binnen via webhooks
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- De authenticatie is geen sleutel maar een toestemming. Weeztix gebruikt de authorization code grant van OAuth2: de gebruiker wordt naar hun server gestuurd, geeft daar akkoord, en jouw applicatie wisselt de code in voor een token. De documentatie zegt er met zoveel woorden bij dat het systeem de tokens veilig moet kunnen bewaren, en er hoort een verversing omheen. Dat is een ander bouwwerk dan een sleutel in een omgevingsvariabele, en het bepaalt waar je koppeling draait.
- De documentatie gaat uit van evenementen op één dag. Weeztix schrijft dat meerdaagse evenementen wel kunnen maar buiten het bestek van de openbare documentatie vallen, en dat er geen plannen zijn om dat publiek te beschrijven; daarvoor mail je hun API-team. Organiseer je een festival of een meerdaagse opleiding, vraag die documentatie dan op voordat het traject begint.
- De standaardlink naar je shop is lang en niet te meten. Dat zegt Weeztix zelf: na het aanmaken van een shop krijg je een link, en die is lang en laat geen verkeersmeting toe. Daar zijn trackers voor. Wil je weten welke pagina of welke campagne de verkoop oplevert, dan regel je dat hier en niet achteraf in je statistieken.
- Eén ticket kan aan meerdere shops hangen, en één shop aan meerdere tickets. Dat is bedoeld om verschillende doelgroepen te bedienen, maar het betekent ook dat de verkoop niet vanzelf bij één pagina hoort. Leg bij het bouwen vast welke shop bij welke pagina staat, anders is achteraf niet na te gaan waar een bestelling vandaan kwam.
Weeztix koppelen
Wat je moet weten voor je begint.
Wat is Weeztix?
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. Daar omheen 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.
Hoe de koppeling met je website werkt
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.
Wat de API kan
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.
De iframe of je eigen pagina’s
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 koppeling 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.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik mijn evenementen uit Weeztix op mijn eigen website tonen?
Ja. Hun REST-API geeft je de evenementen, de datums en de tickets, en daar maken wij eigen pagina’s van op je eigen domein. Weeztix blijft het systeem waarin je de evenementen en de verkoop beheert; je site wordt de plek waar mensen ze vinden.
Heeft Weeztix een API?
Ja, een REST-API met openbare documentatie op docs.weeztix.com. Die dekt locaties, evenementen, tickets, shops, bestellingen, reserveringen, doorverkoop, webhooks en een wachtlijst. De authenticatie gaat met OAuth2.
Kan iemand op mijn eigen site een ticket kopen?
Ja, op twee manieren. Je zet de ticketshop van Weeztix als iframe in je pagina, of je bouwt de bestelstroom zelf op hun API met reserveringen en bestellingen. Het eerste is sneller klaar, het tweede geeft je de volledige controle over de stappen.
Werkt dit ook als mijn evenement meerdere dagen duurt?
Dat kan in het systeem, maar het staat niet in de openbare documentatie. Weeztix beschrijft daar alleen evenementen van één dag en verwijst voor de rest naar hun API-team. Vraag die documentatie op voordat het traject begint, anders loop je er halverwege tegenaan.
Kan ik zien welke pagina de tickets oplevert?
Ja, met trackers. Weeztix zegt zelf dat de standaardlink naar een shop lang is en geen verkeersmeting toelaat; een tracker lost dat op. Zo is te zien welke pagina of campagne tot verkoop leidt in plaats van alleen dat er verkocht is.
Werkt een Weeztix-koppeling ook op WordPress?
Ja. De ticketshop is als codeblok in een WordPress-pagina te zetten, en de evenementen slaan we op als eigen berichttype zodat zoeken, filteren en losse eventpagina’s werken zoals de rest van je site. De tokens blijven aan de serverkant.
Let’s work together.
Je evenementen als eigen pagina’s, je verkoop in Weeztix.