Webhookit

Webhookit: työkalusi saavat tiedon heti, kun ajo päättyy.

Kun erän rikastus tai sisällön luonti valmistuu, epäonnistuu tai pysäytetään, Upsellr lähettää allekirjoitetun tapahtuman valitsemaasi osoitteeseen. Työkalusi jatkaa siitä: julkaisu, tarkistus, vienti.

Kategoria
API
Suunta
Tapahtumien lähetys
Muoto
JSON, allekirjoitettu HMAC-SHA256:lla
Osoitteet
Enintään 25 organisaatiota kohden
Uudelleenyritykset
Enintään 6 yritystä yli vuorokauden aikana
Käyttöönotto
HTTPS-osoite ja salainen avain
Paketit
Enterprise-paketti
Julkaisija
Upsellr

01Mitä webhookit tekevät

Signaali, joka vie työkalujasi eteenpäin.

  1. 01

    Tapahtuma jokaisen ajon päättyessä

    Valmis, epäonnistunut tai pysäytetty: jokaisen rikastus- tai sisällönluontiajon päättyessä Upsellr lähettää tapahtuman ajon tietoineen.

  2. 02

    Allekirjoitettu tarkistettavaksi

    Jokaisessa toimituksessa on tunniste, aikaleima ja salaisella avaimellasi laskettu HMAC-SHA256-allekirjoitus: työkalusi tarkistaa, että se todella tulee Upsellrilta.

  3. 03

    Uudelleen, kunnes se vastaanotetaan

    Jos 2xx-vastausta ei tule 10 sekunnissa, Upsellr yrittää uudelleen 1 minuutin, 5 minuutin, 30 minuutin, 4 tunnin ja lopuksi 24 tunnin kuluttua.

  4. 04

    Loki jokaisesta toimituksesta

    Tila, HTTP-koodi, yritysten määrä ja sisältö: jokaista toimitusta voi tarkastella 7 päivän ajan, ja epäonnistuneen toimituksen voi lähettää uudelleen yhdellä napsautuksella.

  5. 05

    Ketjuta työkalusi

    Julkaise, ilmoita tiimille tai käynnistä vienti heti, kun sivut ovat valmiita: webhook antaa signaalin, työkalusi hoitaa loput.

  6. 06

    Pidä ohjat käsissäsi

    Poista osoite käytöstä, vaihda sen salainen avain tai poista se: sen odottavat uudelleenyritykset perutaan.

02Aloitus

Yhdistetty muutamassa minuutissa.

  1. 01

    Avaa organisaation asetukset

    Osio API ja webhookit, vain omistajille ja ylläpitäjille.

  2. 02

    Lisää osoite

    HTTPS-URL, joka on saavutettavissa internetistä.

  3. 03

    Kopioi salainen avain

    Se näytetään vain kerran, ja sillä tarkistetaan jokaisen toimituksen allekirjoitus.

  4. 04

    Tarkista allekirjoitus

    Laske aikaleiman ja sisällön HMAC-SHA256-allekirjoitus uudelleen ja hylkää liian vanha toimitus.

  5. 05

    Vastaa nopeasti

    2xx-vastaus alle 10 sekunnissa, ja hoida loput omalla puolellasi.

03Tapahtumat

Lähetettävät tapahtumat.

TapahtumaLähetetäänYritetään uudelleen tarvittaessa
Ajo valmis (workflow.run.completed)KylläKyllä
Ajo epäonnistui (workflow.run.failed)KylläKyllä
Ajo pysäytetty (workflow.run.stopped)KylläKyllä

Yhteensopivuus ja vaatimukset

  • Enterprise-paketti
  • Julkinen HTTPS-osoite portissa 443
  • Omistajan tai ylläpitäjän rooli
  • 2xx-vastaus alle 10 sekunnissa
  • Vinkki: poista kaksoiskappaleet tapahtuman tunnisteen perusteella

Sinä päätät

Luotettavia alusta alkaen.

  • Allekirjoitettu HMAC-SHA256:lla, jokaisella osoitteella oma salainen avain
  • Toimitetaan vähintään kerran: poista kaksoiskappaleet tapahtuman tunnisteen perusteella
  • Yritetään uudelleen enintään 6 kertaa yli vuorokauden aikana
  • Lähetetään HTTPS:n kautta, vain julkisiin osoitteisiin

04Kysymykset

Kysymyksiä Upsellrin webhookeista.

Sisältyvätkö webhookit pakettiini?

Ne on varattu Enterprise-paketille, kuten API.

Mitä tapahtumia lähetetään?

Rikastus- tai sisällönluontiajon päättyminen: valmis, epäonnistunut tai pysäytetty. Jokainen tapahtuma sisältää ajon tiedot.

Miten tarkistan, että toimitus tulee Upsellrilta?

Laske aikaleiman ja sisällön HMAC-SHA256-allekirjoitus uudelleen salaisella avaimellasi, vertaa sitä X-Upsellr-Signature-otsakkeeseen ja hylkää yli 5 minuuttia vanha toimitus.

Mitä tapahtuu, jos palvelimeni ei vastaa?

Jos 2xx-vastausta ei tule 10 sekunnissa, Upsellr yrittää uudelleen 1 minuutin, 5 minuutin, 30 minuutin, 4 tunnin ja lopuksi 24 tunnin kuluttua. Epäonnistuneen toimituksen voi myös lähettää uudelleen käsin lokista.

Voinko saada saman tapahtuman kahdesti?

Kyllä, se on mahdollista: toimitus taataan vähintään kerran, ilman taattua järjestystä. Poista kaksoiskappaleet tapahtuman tunnisteen perusteella.

Kuinka kauan lokia säilytetään?

7 päivää, ja siinä on jokaisen toimituksen tila, HTTP-koodi, yritysten määrä ja sisältö.

Montako osoitetta voin lisätä?

Enintään 25 organisaatiota kohden, jokaisella oma salainen avain, jonka voit uusia.

Lähettääkö työnkulkueditorin testi tapahtuman?

Ei. Vain oikeat ajot lähettävät tapahtumia.

Seuraava tuotteesi
ansaitsee muutakin kuin kopioi-liitä.

Anna tekoälytiimillesi ensimmäiset tuotteet työstettäviksi.