Skip to main content
En webhook får Zippendo til å fortelle et annet system om en hendelse, for eksempel Sending sendt eller Sporing oppdatert. Du setter opp webhooks under Innstillinger → Webhooks (åpne organisasjonsmenyen og klikk Administrer). For hver hendelse sender Zippendo en melding til Endpoint URL du har skrevet inn. Dette er ikke sporings-webhooks fra transportører. For dem, se Sporings-webhooks fra transportører.

​
Hva du ser

  • Systemet ditt mottar aldri noe.
  • Leveringslogg for en webhook viser røde statuskoder eller tekst i kolonnen Feil.
  • Systemet ditt mottar den samme hendelsen mer enn én gang.

​
Sjekk først leveringsloggen

Under Webhooks klikker du Leveringslogg på webhooken. Hver rad er ett forsøk, med Hendelse, Status systemet ditt svarte med, Varighet og eventuell Feil.
  • Ingen leveranser ennå: Zippendo har ikke prøvd å sende noe. Se «Ingenting sendes» nedenfor.
  • En grønn status: systemet ditt mottok meldingen. Se etter problemet i ditt eget system.
  • En rød status eller Ikke tilgjengelig med en feil: systemet ditt godtok ikke meldingen. Se «Leveringer feiler» nedenfor.

​
Ingenting sendes

​
Leveringer feiler

Zippendo regner en levering som vellykket bare når systemet ditt svarer med en suksessstatus (200-299) innen 10 sekunder. Ellers prøver det igjen noen ganger i løpet av omtrent ett minutt, 5 forsøk til sammen. Etter det sendes ikke hendelsen på nytt. Etter at du har rettet opp årsaken, klikk Send test på webhooken. Du ser Testhendelsen er sendt, og en ny rad vises i Leveringslogg.
Zippendo sender ikke mislykkede hendelser på nytt senere. Hvis systemet ditt var nede en stund, slå opp sendingene eller ordrene du gikk glipp av i Zippendo-appen, eller hent dem gjennom API-et.

​
Systemet ditt avviser signaturen

Hver melding har en X-Webhook-Signature-header, slik at systemet ditt kan kontrollere at den virkelig kom fra Zippendo. Det er en HMAC-SHA256 av selve meldingsinnholdet, laget med hemmeligheten til webhooken. Vanlige feil:
  • Signaturen beregnes over meldingen etter at den er tolket og skrevet om, i stedet for over selve innholdet nøyaktig slik det ble mottatt.
  • Hemmeligheten til en annen webhook brukes. Hver webhook har sin egen hemmelighet.
Detaljer og kodeeksempler: Kom i gang med webhooks.

​
Den samme hendelsen kommer to ganger

Hvis systemet ditt svarte for sakte eller med en feil, prøver Zippendo igjen, selv om systemet ditt behandlet det første forsøket. Bruk headeren X-Webhook-Id for å kjenne igjen en melding du allerede har behandlet. Se også: Webhooks, Webhook-innstillinger.