Erweiterte Funktion: Diese Funktion wird nur fortgeschrittenen Benutzern empfohlen und erfordert Codierung.

Was ist ein Webhook?

Ein Webhook ist eine Möglichkeit für eine App, andere Apps mit Echtzeitinformationen zu versorgen. Ein Webhook überträgt Daten an andere Anwendungen in Echtzeit, sodass du sie sofort abrufen kannst. Dies unterscheidet ihn von einer typischen API (Programmierschnittstelle), mit der du sehr häufig nach Daten suchen musst, um sie in Echtzeit zu erhalten. Dies macht Webhooks wesentlich effizienter und in den meisten Fällen zu einer besseren Option.

Wann sollte ich einen Webhook verwenden?

Wenn du jedes Mal, wenn ein neues Ticket auf Universe gekauft wird, Daten an deinen Server oder an eine andere Anwendung senden möchtest, die durch unsere Zapier-Integration nicht unterstützt wird, solltest du einen Webhook verwenden.

Wann sollte ich keinen Webhook und stattdessen die API (Programmierschnittstelle) verwenden?

Wenn du möchtest, dass Daten nur gesendet werden, wenn du eine Anfrage initiierst, und du dich darauf beschränken möchtest, nur eine kleinere Teilmenge der Daten zu empfangen.

Was brauche ich, um einen Webhook zu verwenden?

Um einen Webhook verwenden zu können, benötigst du etwas, das auf den Webhook zugreifen kann. Du musst also in der Lage sein, einen Code zu schreiben oder Hilfe von jemandem erhalten, der dies kann.

Was muss ich über einen Universe-Webhook wissen?

Beim Kauf eines Tickets senden wir eine JSON-codierte HTTP- POST- Anfrage an die angegebene Payload-URL mit den folgenden Kopfzeilen:

X-Uniiverse-Event - Ereignisart

X-Uniiverse-Signature - HMAC-Hex-Digest der Payload unter Verwendung des Hook-Geheimnisses als Schlüssel (falls konfiguriert).

Der Hauptteil der Anforderung ist eine JSON-codierte Darstellung der Daten.

Erste Schritte

1. Richte den Webhook ein

Navigiere in deinem Universe-Konto zu ,,Einstellungen". 

2. Scrolle in der Registerkarte ,,Konto" zum Abschnitt ,,Webhooks" und klicke auf ,,Webhook hinzufügen".

3. Konfiguriere den Webhook

Um den Webhook zu konfigurieren, musst du die folgenden Felder ausfüllen:

URL: Dies ist die URL deines Webservices oder was auch immer du eingerichtet hast, um die POST-Anfrage zu bearbeiten.

Wenn du ihn nur testen möchtest, kannst du eine RequestBin-URL (von https://requestbin.com/) als Standort verwenden, um die Universe-Daten vorübergehend zu senden und das Datenformat zu überprüfen.

Geheimnis: Ein Geheimnis ist wie ein Kennwort, das zwischen Universe und deiner App verwendet wird, um zu verhindern, dass andere Apps auf deine Daten zugreifen.

Aktiv: Du müssen dieses Kontrollkästchen aktivieren, wenn du den Webhook aktivieren möchten. Du kannst deinen Webhook jederzeit aktivieren und deaktivieren.

4. Schreibe den Code, um auf die Daten zuzugreifen

Jedes Mal, wenn ein neues Ticket gekauft wird, sendet Universe alle Daten, die du für die Veranstaltung und den Kauf benötigst, um sie in deine App einzufügen.

Hier siehst du eine Musteranfrage mit allen von uns übermittelten Daten.

Eine Erklärung der einzelnen Elemente findest du unter http://developers.universe.com

Events

Derzeit gibt es nur eine Veranstaltung, die einen Webhook auslöst:

ticket_purchase - Jedes Mal, wenn du ein Ticket kaufst oder ein Ticket für eines deiner Angebote gekauft wird.

Fehlerbehebung

Wenn die POST-Anforderung an die Payload-URL aus irgendeinem Grund fehlschlägt, wird der Webhook als inaktiv markiert und du musst ihn in deinen Benutzereinstellungen erneut aktivieren.