Skip to main content
Webhookin avulla Zippendo kertoo toiselle järjestelmälle tapahtumasta, kuten Lähetys lähetetty tai Seuranta päivitetty. Webhookit otetaan käyttöön kohdassa Asetukset → Webhookit (avaa organisaatiovalikko ja napsauta Hallitse). Jokaisesta tapahtumasta Zippendo lähettää viestin antamaasi Päätepisteen URL -osoitteeseen. Nämä eivät ole kuljetusyhtiön seurannan webhookeja. Niistä katso Kuljetusyhtiöiden seurannan webhookit.

​
Mitä näet

  • Järjestelmäsi ei saa mitään.
  • Webhookin Toimitusloki näyttää punaisia tilakoodeja tai tekstiä Virhe-sarakkeessa.
  • Järjestelmäsi saa saman tapahtuman useammin kuin kerran.

​
Tarkista ensin toimitusloki

Napsauta Webhookit-sivulla webhookin kohdalla Toimitusloki. Jokainen rivi on yksi yritys, ja siinä näkyvät Tapahtuma, Tila, jolla järjestelmäsi vastasi, Kesto ja mahdollinen Virhe.
  • Ei vielä toimituksia: Zippendo ei ole yrittänyt lähettää mitään. Katso alla ”Mitään ei lähetetä”.
  • Vihreä tila: järjestelmäsi sai viestin. Etsi ongelmaa omasta järjestelmästäsi.
  • Punainen tila tai Ei tietoa ja virhe: järjestelmäsi ei hyväksynyt viestiä. Katso alla ”Toimitukset epäonnistuvat”.

​
Mitään ei lähetetä

​
Toimitukset epäonnistuvat

Zippendo katsoo toimituksen onnistuneeksi vain, kun järjestelmäsi vastaa onnistumistilalla (200-299) 10 sekunnin kuluessa. Muuten se yrittää uudelleen vielä muutaman kerran noin minuutin sisällä, yhteensä 5 yritystä. Sen jälkeen tapahtumaa ei lähetetä uudelleen. Kun olet korjannut syyn, napsauta webhookin kohdalla Lähetä testi. Näet Testitapahtuma lähetetty, ja kohtaan Toimitusloki ilmestyy uusi rivi.
Zippendo ei lähetä epäonnistuneita tapahtumia myöhemmin uudelleen. Jos järjestelmäsi oli pois käytöstä jonkin aikaa, hae kaipaamasi lähetykset tai tilaukset Zippendo-sovelluksesta tai API:n kautta.

​
Järjestelmäsi hylkää allekirjoituksen

Jokaisessa viestissä on X-Webhook-Signature-otsikko, jotta järjestelmäsi voi tarkistaa, että se tuli todella Zippendosta. Se on viestin raakasisällön HMAC-SHA256, joka on tehty webhookin salaisuudella. Yleisiä virheitä:
  • Allekirjoitus lasketaan viestistä sen jälkeen, kun se on jäsennetty ja kirjoitettu uudelleen, eikä raakasisällöstä täsmälleen sellaisena kuin se vastaanotettiin.
  • Käytetään toisen webhookin salaisuutta. Jokaisella webhookilla on oma salaisuutensa.
Tiedot ja koodiesimerkit: Webhookien pika-aloitus.

​
Sama tapahtuma saapuu kahdesti

Jos järjestelmäsi vastasi liian hitaasti tai virheellä, Zippendo yrittää uudelleen, vaikka järjestelmäsi olisi käsitellyt ensimmäisen yrityksen. Käytä X-Webhook-Id-otsikkoa tunnistaaksesi viestin, jonka olet jo käsitellyt. Liittyvää: Webhookit, Webhook-asetukset.