Lisäominaisuus: tätä ominaisuutta suositellaan vain edistyneille käyttäjille, ja se vaatii koodausta.

Mikä on webhook?

Webhook on tapa, jolla sovellus voi tarjota muille sovelluksille reaaliaikaista tietoa. Webhook toimittaa tietoja muille sovelluksille sitä mukaa kuin niitä tapahtuu, eli saatte tiedot välittömästi. Tämä eroaa tyypillisestä API-palvelusta, jossa tietoja on kysyttävä jatkuvasti, jotta ne saataisiin reaaliaikaisesti. Tästä syystä webhookit ovat paljon tehokkaampia ja useimmissa tapauksissa parempi vaihtoehto.

Milloin webhookia pitäisi käyttää?

Jos haluatte lähettää tietoja palvelimellenne tai muuhun sovellukseen, jota ei tueta Zapier-integraatiomme kautta, aina kun uusi lippu ostetaan Universe-sivustolla, teidän on käytettävä webhookia.

Milloin pitäisi käyttää APIa eikä webhookia?

Jos haluatte, että tietoja lähetetään vain silloin, kun käynnistätte pyynnön, ja haluatte rajoittaa tietojen vastaanottamistiheyttä.

Mitä tarvitsen voidakseni käyttää webhookia?

Voidaksenne käyttää webhookia, teillä on oltava jokin keino pystyä käyttämään webhookia. Teidän on siis osattava kirjoittaa koodia tai saada apua joltakulta, joka osaa.

Mitä minun on tiedettävä Universen webhookista?

Aina kun ostetaan lippu lähetämme JSON-koodatunHTTP POST -pyynnön annettuun Payload URL -osoitteeseen seuraavilla otsikoilla:

X-Uniiverse-Event – tapahtumatyyppi

X-Uniiverse-Signature – maksun HMAC-heksanlukumuoto, jossa käytetään koukun salaisuutta avaimena (jos määritetty).

Pyynnön runko on JSON-koodattuesitys tiedoista.

Aloittaminen:

1. Webhookin asettaminen

Siirtykää Universe-tilillänne kohtaanAsetukset. 

2. Vierittäkää Tili-välilehteä alaspäin webhook-osioon ja napsauttakaaLisää webhook.

3. Määrittäkää webhook

Määrittääksenne webhookin teidän on täytettävä seuraavat kentät:

URL-osoite: tämä on verkkopalvelun URL-osoite tai mikä tahansa muu, jonka olette määrittänyt käyttämään POST-pyyntöä.

Jos haluatte vain testata sitä, voitte käyttää RequestBin URL -osoitetta (osoitteesta https://requestbin.com/), johon voitte lähettää väliaikaisesti Universe-tiedot ja tutkia tietojen muotoa.

Salaisuus: salaisuus on kuin salasana, jota käytetään Universen ja sovelluksenne välillä, jotta muut sovellukset eivät pääse käsiksi tietoihin.

Aktiivinen: tämä ruutu on valittava, jos haluatte aktivoida webhookin. Voitte ottaa webhookin käyttöön ja poistaa sen käytöstä milloin tahansa.

4. Kirjoittakaa koodia tietojen käyttämistä varten

Joka kerta kun ostetaan uusi lippu, Universe lähettää kaikki tapahtumaan ja ostoon liittyvät tiedot, joita tarvitsette sovelluksenne täyttämiseksi.

Näette esimerkkipyynnön, joka sisältää kaikki lähettämämme tiedot, täällä.

Löydätte selityksen kustakin kohteesta osoitteesta http://developers.universe.com

Tapahtumat

Tällä hetkellä on kaksi tapahtumaa, jotka käynnistävät webhookin:

lipun_osto – aina kun ostatte lipun, tai kun lippu ostetaan johonkin tapahtumaanne.

lipun_päivitys – aina kun lipun tila muuttuu (esim. maksetusta peruutetuksi jne.).

Huomautus: nämä tapahtumat käyttävät samaa dataa.

Vianmääritys

Jos POST-pyyntö hyötykuorman URL-osoitteeseen jostain syystä epäonnistuu, webhook merkitään inaktiiviseksi, ja teidän on otettava se uudelleen käyttöön käyttäjäasetuksista.