Avancerad funktion: Den här funktionen rekommenderas endast för avancerade användare och kräver kodning.

Vad är en webhook?

En webhook är ett sätt för en app att ge andra appar information i realtid. En webhook levererar data till andra applikationer direkt när det inträffar, vilket innebär att du får data omedelbart. Det skiljer sig från ett vanlig API, där du måste polla efter data väldigt ofta för att få den i realtid. Detta gör webhooks mycket effektivare och i de flesta fall ett bättre alternativ.

När ska jag använda en webhook?

Om du vill skicka data varje gång en ny biljett köps på Universe till din server eller ett annat program som inte stöds genom vår zapier- integration, ska du använda en webhook.

När borde jag inte använda en webhook och istället använda API?

Om du bara vill att data ska skickas när du initierar begäran, och du vill begränsa till att endast få en mindre delmängd av data.

Vad behöver jag för att använda en webhook?

För att kunna använda en webhook måste du ha något som kommer att kunna konsumera webhooken. Så du måste kunna skriva lite kod eller få hjälp av någon som kan det.

Vad behöver jag veta om en Universe-webhook?

När en biljett köps skickar vi en JSON-kodad HTTP POST-b egäran till den angivna Payload-webbadressen med följande rubriker:

X-Uniiverse-Event - Evenemangstyp

X-Uniiverse-Signature - HMAC hex av payload, med webhookens hemlighet som nyckel (om den är konfigurerad).

Förfrågan kommer att vara en JSON-kodad representation av data.

Kom igång:

1. Ställ in webhooken

Gå till "Inställningar" i ditt Universe-konto. 

2. Under fliken "Konto" bläddrar du ner till webhook-avsnittet och klickar på "Lägg till webhook"

3. Konfigurera webhooken

För att konfigurera webhooken måste du fylla i följande fält:

URL: Detta är webbadressen till din webbservice, eller vad det nu är du har ställt in för att behandla POST-förfrågan.

Om du vill testa det kan du använda en RequestBin-URL (från https://requestbin.com/) som plats dit du tillfälligt kan skicka Universe-data och undersöka formatet

Hemlighet: En hemlighet är som ett lösenord som används mellan Universe och din app, för att stoppa andra appar från att komma åt dina data.

Aktiv: Du måste kryssa i den här rutan om du vill aktivera din webhook. Du kan aktivera och inaktivera din webhook när som helst.

4. Skriv kod för att konsumera data

Varje gång en ny biljett köps, skickar Universe all information du behöver i samband med händelsen och köpet som sparas i din app.

Du kan se en provförfrågan som innehåller alla data vi skickar här.

Du hittar en förklaring av varje objekt på http://developers.universe.com

Event

För närvarande finns det bara en händelse som utlöser en webhook:

ticket_purchase  - Varje gång du köper en biljett, eller en biljett köps till ett av dina event.

Felsökning

Om POST-förfrågan till webbläsningsadressen av någon anledning misslyckas, kommer webhooken att markeras som inaktiv, och du måste aktivera den igen via dina användarinställningar.