Avansert funksjon: Denne funksjonen er kun anbefalt for avanserte brukere og krever koding.

Hva er en webhook?

En webhook er en måte for en app å gi andre apper sanntidsinformasjon. En webhook leverer data til andre programmer i sanntid, noe som betyr at du får data umiddelbart. Dette er forskjellig fra en typisk API (Application Programming Interface), hvor du må trekke ut data regelmessig for å få det i sanntid. Dette gjør webhooks mye mer effektive, og i de fleste tilfeller, et bedre alternativ.

Når skal jeg bruke en webhook?

Hvis du vil sende data til serveren din hver gang en ny billett er kjøpt på Universe eller til et annet program som ikke støttes gjennom vår Zapier-integrasjon, så bør du bruke en webhook.

Når skal jeg ikke bruke webhook og heller bruke API (Application Programming Interface)?

Hvis du bare vil at data skal sendes når du starter forespørselen, og du vil begrense det til en mindre delmengde av dataene.

Hva trenger jeg for å bruke en webhook?

For å kunne bruke en webhook, må du ha noe som vil kunne konsumere webhooken. Så du må kunne skrive kode eller få hjelp fra noen som kan.

Hva trenger jeg å vite om en Universe webhook?

Når en billett er kjøpt, sender vi en JSON-kodet HTTP POST forespørsel til den angitte Payload URL-en med følgende overskrifter:

X-Uniiverse-Event - Arrangementstype

X-Uniiverse-Signature - HMAC hex fordøying av payloaden, bruk krokens hemmelighet som nøkkel (hvis konfigurert).

Hovedgrunnen for forespørselen vil være en JSON-kodet representasjon av dataene.

Oppstart:

1. Sett opp Webhook

Finn frem til 'Innstillinger' på din 'Universe-konto'. 

2. I fanen 'Konto' ruller du ned til webhookdelen og klikker på 'Legg til webhook'

3. Konfigurer Webhooken

For å konfigurere webhook må du fylle ut følgende felt:

URL: Dette vil være URL-adressen til din webservice, eller hva du har satt opp for å konsumere POST-forespørselen.

Hvis du bare vil teste, kan du bruke en RequestBin-URL (fra https://requestbin.com/) som et sted å midlertidig sende Universedata og undersøke dataformatet

Hemmelighet: En hemmelighet er som et passord som brukes mellom Universe og appen din, for å hindre andre apper fra å få tilgang til dataene dine.

Aktiv: Du må merke denne boksen hvis du vil aktivere webhooken. Du kan når som helst aktivere og deaktivere webhooken din.

4. Skriv kode for å konsumere dataene

Hver gang en ny billett er kjøpt, sender Universe alle dataene du trenger i forbindelse med arrangementet og kjøpet, som fylles opp i appen din.

Du kan se en prøveforespørsel som inneholder alle dataene vi sender her.

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

Events

Foreløpig er det bare en begivenhet som utløser en webhook:

ticket_purchase - Hver gang du kjøper en billett, eller en billett er kjøpt for en av dine oppføringer.

Feilsøking

Hvis POST-forespørselen til Payload-webadressen mislykkes av en eller annen grunn, vil webhooken bli merket som inaktiv og du må aktivere den på nytt fra b rukerinstillinger.