Avansert funksjon: Denne funksjonen anbefales kun 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 applikasjoner mens det skjer, noe som betyr at du får data umiddelbart. Dette er forskjellig fra en typisk API, hvor du må spørre etter data veldig ofte for å få det i sanntid. Dette gjør webhooks mye mer effektive, og i de fleste tilfeller et bedre alternativ.
Når bør jeg bruke en webhook?
Hvis du ønsker å sende data hver gang en ny billett kjøpes på Universe, enten til serveren din eller en annen applikasjon som ikke støttes gjennom vår Zapier-integrasjon, bør du bruke en webhook.
Når bør jeg ikke bruke en webhook og bør bruke API i stedet?
Hvis du bare vil at data skal sendes når du starter forespørselen, og du vil begrense til kun å motta et mindre delsett av dataene.
Hva trenger jeg for å bruke en webhook?
For å bruke en webhook må du ha noe som vil kunne konsumere webhooken. Så du må kunne skrive litt kode eller få hjelp fra noen som gjør det.
Hva trenger jeg å vite om en Universe webhook?
Hver gang en billett kjøpes vil vi sende en JSON-kodetHTTP POST-forespørsel til den oppgitte datalast nettadressen med følgende overskrifter:
X-Uniiverse-Event – Hendelsestype
X-Uniiverse-Signatur – HMAC hex-sammendrag av datalasten, ved å bruke hookens hemmelighet som nøkkel (hvis konfigurert).
Brødteksten i forespørselen vil være en JSON-kodetrepresentasjon av dataene.
Starter:
1. Sett opp Webhook
Naviger til 'Innstillinger' i Universe-kontoen din.
2. I 'konto'-fanen, rull ned til Webhooks-delen og klikk på 'Add Webhook'
3. Konfigurer Webhook
For å konfigurere Webhook må du fylle ut følgende felt:
URL: dette vil være URL-en til webtjenesten din, eller hva som helst du har satt opp for å konsumere POST-forespørselen.
Hvis du bare vil teste det ut kan du bruke en RequestBin URL (fra https://requestbin.com/) som et sted for midlertidig å sende Universe-dataen og undersøke dataformatet
Hemmelighet: en hemmelighet er som et passord som brukes mellom Universe og appen din, for å forhindre at andre apper får tilgang til dine data.
Aktiv: Du må krysse av i denne boksen hvis du vil aktivere webhook. Du kan aktivere og deaktivere din webhook når som helst.
4. Skriv kode for å konsumere data
Hver gang en ny billett kjøpes sender Universe all data du trenger knyttet til arrangementet og kjøpet for å fylle ut i appen din.
Du kan se en prøveforespørsel som inneholder all data vi sender her.
Du kan finne en forklaring av hvert objekt på http://developers.universe.com
Eventer
For øyeblikket er det to eventer som utløser en webhook:
ticket_purchase – Hver gang du kjøper en billett, eller en billett er kjøpt for en av oppføringene dine.
ticket_update – Hver gang billettstatusen endres (dvs. fra betalt til kansellert osv.).
Merk: disse eventene deler samme datalast.
Feilsøking
Hvis POST-forespørselen til nettadressen for datalast av en eller annen grunn mislykkes vil webhooken bli merket som inaktiv, og du må aktivere den på nytt fra brukerinnstillingene dine.