Lytt til hendelser med webhooks

Webhooks gir en måte for Zonos å proaktivt varsle dine eksterne systemer når visse hendelser finner sted. Når den abonnerte hendelsen skjer, vil Zonos sende en HTTP POST-forespørsel til webhook-URL-en du spesifiserer. Forespørselens kropp vil inneholde hendelsesdetaljene, slik at systemet ditt kan håndtere hendelsen programmessig.

Webhooks er nyttige for å integrere Zonos med andre plattformer, utløse automatiserte arbeidsflyter og holde data synkronisert på tvers av systemer i sanntid. For eksempel kan du bruke webhooks til å:

• Oppdatere bestillingshåndteringssystemet ditt når en bestilling opprettes i Zonos
• Varsle oppfyllingsleverandøren din når en forsendelse blir kansellert
• Loggføre statusendringer av internasjonale bestillinger for revisjonsformål

Webhook-typer 

Alle tilgjengelige webhook-typer er inkludert i WebhookType enum. Eksempelpayloads for hver kan finnes i vår Hendelsestyper guide.

Opprette webhooks 

For å opprette en webhook via API-en:

mutation {
  webhookCreate(
    input: {
      url: "https://example.com/webhooks/zonos"
      type: ORDER_CREATED
      status: ENABLED
    }
  ) {
    id
    url
    type
    status
  }
}

Rediger webhook-detaljer 

For å redigere en eksisterende webhook via API-en:

mutation {
  webhookUpdate(
    input: {
      id: "webhook-id"
      url: "https://example.com/webhooks/zonos"
      type: ORDER_CREATED
      status: ENABLED
    }
  ) {
    id
    url
    type
    status
  }
}

Vis webhook logger 

For å se webhook logger via API-en:

query {
  webhookLogs(first: 20, after: "yyyyyyy", filter: { type: ORDER_CREATED }) {
    edges {
      node {
        id
        type
        url
        createdAt
        responseStatus
      }
    }
  }
}