Avancerad funktion: Denna funktion 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 förse andra appar med realtidsinformation. En webhook levererar data till andra applikationer samtidigt som det händer, vilket innebär att du får data omedelbart. Detta skiljer sig från ett vanligt API, där du måste fråga efter data mycket ofta för att få dem i realtid. Detta gör webhooks mycket mer effektiva 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 en annan applikation som inte stöds av vår Zapier-integration bör du använda en webhook.

När ska jag inte använda en webhook utan istället använda API:et?

Om du bara vill att data ska skickas när du initierar begäran, och du vill begränsa mottagandet till en mindre del av dataunderlaget.

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 kan konsumera webhooken. Därför måste du kunna skriva 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-kodadHTTP POST-förfrågan till den angivna Payload-URL:en med följande rubriker:

X-Uniiverse-Event – Händelsetyp

X-Uniiverse-Signature – HMAC hex digest av nyttolasten, med webhookens hemlighet som nyckel (om konfigurerad).

Huvuddelen av begäran kommer att vara en JSON-kodadrepresentation av data.

Komma igång med arbetet:

1. Konfigurera webhooken

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

2. På fliken "Konto" rullar du ner till avsnittet webhooks och klickar på "Lägg till webhook"

3. Konfigurera webhook

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

URL: detta kommer att vara webbadressen till din webbtjänst, eller det du har konfigurerat för att konsumera POST-förfrågan.

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

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

Aktiv: Du måste markera denna ruta om du vill aktivera webhooken. 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 som behövs för att eventet och köpet ska kunna visas i din app.

Här kan du se ett exempel på en förfrågan som innehåller alla de uppgifter vi skickar.

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

Event

För närvarande finns det två event som utlöser en webhook:

ticket_purchase – När du köper en biljett eller när en biljett köps för en av dina annonser.

ticket_update – Varje gång biljettens status ändras (t.ex. från betald till avbokad, etc.).

Observera: dessa event delar samma datanyttolast.

Felsökning

Om POST-begäran till Payload URL av någon anledning misslyckas kommer webhooken att markeras som inaktiv och du måste aktivera den igen från dina användarinställningar.