Avanceret funktion: Denne funktion anbefales kun til avancerede brugere og kræver kodning.

Hvad er et webhook?

Et webhook er en måde, hvorpå en app kan give andre apps information i realtid. Et webhook leverer data til andre applikationer, når det sker, hvilket betyder, at du får data med det samme. Det adskiller sig fra en typisk API, hvor man skal bede om data meget ofte for at få dem i realtid. Det gør webhooks meget mere effektive og i de fleste tilfælde til en bedre løsning.

Hvornår skal jeg bruge et webhook?

Hvis du vil sende data, hver gang der købes en ny billet på Universe, til din server eller et andet program, som ikke understøttes af vores zapier-integration, skal du bruge et webhook.

Hvornår bør jeg ikke bruge et webhook, men i stedet API'et?

Hvis du kun vil have data sendt, når du starter anmodningen, og du vil begrænse dig til kun at modtage en mindre delmængde af dataene.

Hvad skal jeg bruge for at bruge et webhook?

For at kunne bruge et webhook skal du have noget, der kan forbruge webhook'et. Så du bliver nødt til at kunne skrive noget kode eller få hjælp fra nogen, der kan.

Hvad skal jeg vide om et Universe-webhook?

Når en billet er købt, sender vi en JSON-kodetHTTP POST-anmodning til den angivne Payload URL med følgende overskrifter:

X-Uniiverse-Event - Begivenhedstype

X-Uniiverse-Signature - HMAC hex digest af payload, med hookens hemmelighed som nøgle (hvis konfigureret).

Anmodningens brødtekst vil være en JSON-kodetrepræsentation af dataene.

Kom godt i gang:

1. Opsætning af webhook

Gå til 'Indstillinger' på din Universe-konto. 

2. I fanen 'konto' ruller du ned til sektionen webhooks og klikker på 'Tilføj webhook'.

3. Konfigurer webhook'et

For at konfigurere et webhook skal du udfylde følgende felter:

URL: dette vil være URL'en til din webservice, eller hvad du nu har sat op til at bruge POST-anmodningen.

Hvis du bare vil teste det, kan du bruge en RequestBin URL (fra https://requestbin.com/) som et midlertidigt sted at sende Universe-data og undersøge dataformatet

Hemmelig: En hemmelighed er som et password, der bruges mellem Universe og din app for at forhindre andre apps i at få adgang til dine data.

Aktiv: Du skal markere dette felt, hvis du vil aktivere dit webhook. Du kan til enhver tid aktivere og deaktivere dit webhook.

4. Skriv kode til at forbruge data

Hver gang en ny billet købes, sender Universe alle de data, du skal bruge i forbindelse med begivenheden og købet, så de kan udfyldes i din app.

Du kan se et eksempel på en anmodning, der indeholder alle de data, vi sender, her.

Du kan finde en forklaring af hvert objekt på http://developers.universe.com

Begivenheder

I øjeblikket er der to begivenheder, der udløser et webhook:

ticket_purchase - Hver gang du køber en billet, eller der købes en billet til en af dine lister.

ticket_update - Hver gang billetstatus ændres (f.eks. fra betalt til annulleret osv.).

Bemærk: Disse begivenheder deler den samme data-nyttelast.

Fejlfinding

Hvis POST-anmodningen til Payload-URL'en af en eller anden grund mislykkes, vil dit webhook blive markeret som inaktivt, og du skal genaktivere det i dine brugerindstillinger.