Geavanceerde functie: deze functie wordt alleen aanbevolen voor ervaren gebruikers en vereist codering.

Wat is een webhook?

Een webhook is een manier waarop een app andere apps van real-time informatie te voorzien. Een webhook levert gegevens aan andere toepassingen zo gezegd, wat betekent dat u onmiddellijk gegevens krijgt. Dit is anders dan bij een typische API, waar u zeer vaak naar gegevens moet vragen om deze real-time te krijgen. Dit maakt webhooks veel efficiënter en in de meeste gevallen een betere optie.

Wanneer moet ik een webhook gebruiken?

Als u, elke keer dat er een nieuw ticket wordt gekocht op Universe, gegevens wilt verzenden naar uw server of een andere toepassing die niet wordt ondersteund door onze Zapier-integratie, dan moet u een webhook gebruiken.

Wanneer moet ik geen webhook gebruiken en in plaats daarvan de API?

Als u alleen gegevens wilt verzenden wanneer u het verzoek start en u zich wilt beperken tot het ontvangen van een kleinere subset van de gegevens.

Wat heb ik nodig om een webhook te gebruiken?

Om een webhook te kunnen gebruiken, moet u iets hebben dat de webhook kan gebruiken. U zult dus wat code moeten kunnen schrijven of hulp moeten krijgen van iemand die dat doet.

Wat moet ik weten over een Universe webhook?

Telkens als er een ticket wordt gekocht, sturen we een JSON-gecodeerdHTTP POST-verzoek naar de opgegeven Payload URL met de volgende headers:

X-Uniiverse-Event - Event type

X-Uniiverse-Signature - HMAC hex digest van de payload, met het geheim van de hook als sleutel (indien geconfigureerd).

De inhoud van het verzoek zal een JSON-gecodeerdeweergave van de gegevens zijn.

Aan de slag:

1. De webhook instellen

Navigeer naar "Instellingen" in uw Universe-account. 

2. Scroll in het tabblad 'Account' omlaag naar de sectie "Webhooks" en klik op "Webhook toevoegen".

3. De webhook configureren

Om de webhook te configureren, moet u de volgende velden invullen:

URL: dit is de URL van uw webservice, of wat u ook hebt ingesteld om het POST-verzoek te gebruiken.

Als u het gewoon wilt uitproberen, kunt u een RequestBin URL (van https://requestbin.com/) gebruiken als een plaats om tijdelijk de Universe-gegevens naar toe te sturen en het gegevensformaat te onderzoeken

Geheim: een geheim is als een wachtwoord dat wordt gebruikt tussen Universe en uw app, om te voorkomen dat andere apps toegang krijgen tot uw gegevens.

Actief: u moet dit vakje aanvinken als u de webhook wilt activeren. U kunt uw webhook op elk moment in- en uitschakelen.

4. Schrijf code om de gegevens te gebruiken

Telkens als er een nieuw ticket wordt gekocht, stuurt Universe alle gegevens die u nodig hebt voor het event en de aankoop naar uw app.

U kunt hier een voorbeeldverzoek bekijken met alle gegevens die we verzenden.

U kunt een uitleg van elk object vinden op http://developers.universe.com.

Events

Momenteel zijn er twee events die een webhook activeren:

Ticket-aankoop - Elke keer dat u een ticket koopt, of als er een ticket wordt gekocht voor een van uw aanbiedingen.

Ticket-update - Elke keer dat de status van het ticket verandert (bijvoorbeeld van betaald naar geannuleerd, enz.).

Opmerking: deze events delen dezelfde payload.

Stappen voor probleemoplossing

Als het POST-verzoek naar de payload-URL om de een of andere reden mislukt, wordt de webhook als 'inactief' gemarkeerd en moet u dit opnieuw inschakelen via uw gebruikersinstellingen.