Skip to main content
En webhook får Zippendo til at fortælle et andet system om en hændelse, såsom Forsendelse afsendt eller Tracking opdateret. Du sætter webhooks op under Indstillinger → Webhooks (åbn organisationsmenuen, og klik på Administrer). For hver hændelse sender Zippendo en besked til den Endpoint-URL, du har skrevet. Det er ikke tracking-webhooks fra transportører. Dem kan du læse om i Tracking-webhooks fra transportører.

​
Det her ser du

  • Dit system modtager aldrig noget.
  • Leveringslog for en webhook viser røde statuskoder eller tekst i kolonnen Fejl.
  • Dit system modtager den samme hændelse mere end én gang.

​
Tjek først leveringsloggen

Klik på Leveringslog på webhooken under Webhooks. Hver række er ét forsøg, med Hændelse, den Status, dit system svarede med, Varighed og eventuel Fejl.
  • Ingen leveringer endnu: Zippendo har ikke forsøgt at sende noget. Se “Der sendes ikke noget” nedenfor.
  • En grøn status: dit system modtog beskeden. Led efter problemet i dit eget system.
  • En rød status eller N/A med en fejl: dit system accepterede ikke beskeden. Se “Leveringer fejler” nedenfor.

​
Der sendes ikke noget

​
Leveringer fejler

Zippendo tæller kun en levering som lykkedes, når dit system svarer med en successtatus (200-299) inden for 10 sekunder. Ellers prøver Zippendo igen nogle gange inden for cirka et minut, i alt 5 forsøg. Derefter sendes hændelsen ikke igen. Når du har rettet årsagen, så klik på Send test på webhooken. Du ser Testhændelse sendt, og en ny række vises i Leveringslog.
Zippendo sender ikke mislykkede hændelser igen senere. Hvis dit system var nede i en periode, så slå de forsendelser eller ordrer, du gik glip af, op i Zippendo-appen, eller hent dem via API’et.

​
Dit system afviser signaturen

Hver besked har headeren X-Webhook-Signature, så dit system kan tjekke, at den virkelig kom fra Zippendo. Det er en HMAC-SHA256 af beskedens rå body, lavet med webhookens secret. Almindelige fejl:
  • Signaturen beregnes over beskeden, efter at den er blevet parset og omskrevet, i stedet for over den rå body præcis som modtaget.
  • Der bruges en anden webhooks secret. Hver webhook har sin egen secret.
Detaljer og kodeeksempler: Kom i gang med webhooks.

​
Den samme hændelse kommer to gange

Hvis dit system svarede for langsomt eller med en fejl, prøver Zippendo igen, også selv om dit system faktisk behandlede det første forsøg. Brug headeren X-Webhook-Id til at genkende en besked, du allerede har behandlet. Relateret: Webhooks, Webhook-indstillinger.