Hören Sie auf Ereignisse mit Webhooks

Webhooks bieten eine Möglichkeit für Zonos, Ihre externen Systeme proaktiv zu benachrichtigen, wann immer bestimmte Ereignisse eintreten. Wenn das abonnierte Ereignis eintritt, sendet Zonos eine HTTP POST-Anfrage an die von Ihnen angegebene Webhook-URL. Der Anfrageinhalt enthält die Ereignisdetails, sodass Ihr System das Ereignis programmgesteuert verarbeiten kann.

Webhooks sind nützlich, um Zonos mit anderen Plattformen zu integrieren, automatisierte Workflows auszulösen und Daten in Echtzeit zwischen Systemen synchron zu halten. Zum Beispiel könnten Sie Webhooks verwenden, um:

• Ihr Bestellmanagementsystem zu aktualisieren, wenn eine Bestellung in Zonos erstellt wird
• Ihren Fulfillment-Anbieter zu benachrichtigen, wenn eine Sendung storniert wird
• Statusänderungen internationaler Bestellungen zu Protokollierungszwecken zu erfassen

Webhook-Typen 

Alle verfügbaren Webhook-Typen sind im WebhookType Enum enthalten. Beispielpayloads für jeden finden Sie in unserem Ereignistypen Leitfaden.

Erstellen von Webhooks 

Um einen Webhook über die API zu erstellen:

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

Webhook-Details bearbeiten 

Um einen bestehenden Webhook über die API zu bearbeiten:

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

Webhook-Protokolle anzeigen 

Um Webhook-Protokolle über die API anzuzeigen:

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