Lisäominaisuus: Tätä ominaisuutta suositellaan vain edistyneille käyttäjille, sillä se vaatii koodaustaitoa.

Mikä on webhook?

Webhook on tapa, jolla sovellus voi tarjota muille sovelluksille tietoja reaaliaikaisesti. Webhook toimittaa tietoja muille sovelluksille niiden tapahtuessa, joten saat tiedot välittömästi. Tämä eroaa tyypillisestä API: sta, jossa sinun on pyydettävä tietoja hyvin usein saadaaksesi ne reaaliaikaisesti. Tämä tekee webhookeista paljon tehokkaampia ja useimmissa tapauksissa paremman vaihtoehdon.

Milloin minun pitäisi käyttää webhookia?

Jos haluat lähettää tietoja joka kerta, kun Universessa ostetaan uusi lippu, palvelimellesi tai muulle sovellukselle, jota ei tueta Zapier -integraation kautta, sinun pitäisi käyttää webhookia.

Milloin minun ei pitäisi käyttää webhookia ja käyttää sen sijaan API: a?

Jos haluat tietoja lähtevän ainoastaan, kun pyydät sitä, ja haluat rajoittaa vastaanottamisen vain pienemmän osajoukon tietoihin.

Mitä tarvitsen webhookin käyttämiseksi?

Jotta voit käyttää webhookia, sinulla on oltava jotain, joka voi hyödyntää webhookia. Sinun on pystyttävä kirjoittamaan koodia tai saatava apua joltakulta, joka osaa koodata.

Mitä minun täytyy tietää Universe -webhookista?

Aina kun lippu ostetaan, lähetämme a JSON– koodatun HTTP VIESTI pyynnön annettuun Kuorman URL-osoitteeseen seuraavilla otsikoilla:

X-Uniiverse-Tapahtuma – Tapahtumatyyppi

X-Uniiverse-allekirjoitus – HMAC hex digest kuormasta käyttäen hookin salausta avaimena (jos konfiguroitu).

Pyynnön runko on JSON-koodattu tietojen esitysmuoto.

Päästäksesi alkuun:

1. Määritä Webhook

Siirry"Asetukset"- osioon Universe-tililläsisi. 

2. Selaa "Tili"-välilehdellä alas Webhookit-osioon ja napsauta "Lisää Webhook"

3. Määritä Webhook

Webhookinmäärittäminenedellyttääseuraavienkenttientäyttämistä:

URL: tämä on verkkopalvelun URL-osoite tai mitä ikinä olet asettanut hyödyntämään POST-pyyntöä.

Jos haluat vain testata toimivuutta, voit käyttää RequestBin-URL-osoitetta (alkaen http://requestb.in/) paikkana lähettää Universe -tiedot väliaikaisesti. Samalla voit tutkia datan formaattia.

Salaisuus: salaisuus on kuin Universen ja sovelluksesi välinen salasana, jotta muut sovellukset eivät pääse käyttämään tietojasi.

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

4. Kirjoita koodi, joka hyödyntää tietoa

Joka kerta kun uusi lippu ostetaan, Universe lähettää kaikki tarvitsemasi tapahtumaan ja ostoon liittyvät tiedot, jotta voit hyödyntää niitä sovelluksessasi.

Näet esimerkkipyynnön, joka sisältää kaikki lähetettämämme tiedot tästä.

Löydät jokaisen objektin selityksen osoitteessa http://developers.universe.com

Tapahtumat

Tällä hetkellä on vain yksi tapahtuma, joka käynnistää webhookin:

ticket_purchase – Aina kun ostat lipun tai, kun lippu ostetaan yhteen tapahtumistasi.

Ongelmien kartoittaminen

Jos jostain syystä POST-pyyntö Payload-URL-osoitteeseen epäonnistuu, webhook merkitään ei-aktiiviseksi, ja sinun täytyy ottaa se uudelleen käyttöön käyttäjä asetuksistasi.