Erweiterte Funktion: Diese Funktion wird nur für fortgeschrittene Benutzer 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 liefert Daten an andere Anwendungen, sobald sie anfallen, d.h. Sie erhalten die Daten sofort. Dies unterscheidet sich von einer typischen API, bei der Sie die Daten sehr häufig abfragen müssen, um sie in Echtzeit zu erhalten. Das macht Webhooks viel effizienter und in den meisten Fällen zu einer besseren Option.

Wann sollte ich einen Webhook verwenden?

Wenn Sie jedes Mal, wenn ein neues Ticket auf Universe gekauft wird, Daten an Ihren Server oder eine andere Anwendung senden möchten, die nicht von unserer Zapier-Integration unterstützt wird, dann sollten Sie einen Webhook verwenden.

Wann sollte ich keinen Webhook verwenden und stattdessen die API nutzen?

Wenn Sie möchten, dass die Daten nur gesendet werden, wenn Sie die Anfrage initiieren, und Sie sich darauf beschränken möchten, nur eine kleinere Teilmenge der Daten zu erhalten.

Was benötige ich, um einen Webhook zu verwenden?

Um einen Webhook zu verwenden, müssen Sie etwas haben, das den Webhook verarbeiten kann. Sie müssen also in der Lage sein, Code zu schreiben, oder sich von jemandem helfen lassen, der das kann.

Was muss ich über einen Universe Webhook wissen?

Immer wenn ein Ticket gekauft wird, senden wir eine JSON-codierteHTTP POST-Anfrage an die angegebene Payload-URL mit den folgenden Kopfzeilen:

X-Uniiverse-Event – Event-Typ

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

Der Hauptteil der Anfrage ist eine JSON-codierteDarstellung der Daten.

Erste Schritte:

1. Einrichten des Webhooks

Navigieren Sie zu „Einstellungen“ auf Ihrem Universe-Konto. 

2. Scrollen Sie auf der Registerkarte „Konto“ zum Abschnitt „Webhooks“ und klicken Sie auf „Webhook hinzufügen".

3. Konfigurieren des Webhooks

Um den Webhook zu konfigurieren, müssen Sie die folgenden Felder ausfüllen:

URL: Dies ist die URL Ihres Webservice oder was auch immer Sie für die POST-Anfrage eingerichtet haben.

Wenn Sie es nur testen möchten, können Sie eine RequestBin URL (von https://requestbin.com/) als Ort verwenden, um die Universe-Daten vorübergehend zu senden und das Datenformat zu untersuchen

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

Aktivieren: Sie müssen dieses Kästchen markieren, wenn Sie den Webhook aktivieren möchten. Sie können Ihren Webhook jederzeit aktivieren und deaktivieren.

4. Schreiben Sie Code, um die Daten zu verarbeiten

Jedes Mal, wenn ein neues Ticket gekauft wird, sendet Universe alle Daten, die Sie im Zusammenhang mit dem Event und dem Kauf benötigen, um sie in Ihre App zu übertragen.

Ein Beispiel für eine Anfrage mit allen Daten, die wir senden, finden Sie hier.

Eine Erklärung der einzelnen Objekte finden Sie unter http://developers.universe.com

Events

Derzeit gibt es zwei Events, die einen Webhook auslösen:

ticket_purchase – Jedes Mal, wenn Sie ein Ticket kaufen, oder wenn ein Ticket für eines Ihrer Angebote gekauft wird.

ticket_update – Jedes Mal, wenn sich der Status des Tickets ändert (z. B. von bezahlt zu storniert usw.).

Hinweis: Diese Events teilen sich die gleiche Datennutzlast.

Fehlerbehebung

Wenn die POST-Anfrage an die Payload-URL aus irgendeinem Grund fehlschlägt, wird der Webhook als inaktiv markiert und Sie müssen ihn über Ihre Benutzereinstellungen wieder aktivieren.