Luister naar evenementen met webhooks

Webhooks bieden een manier voor Zonos om uw externe systemen proactief te informeren wanneer bepaalde evenementen plaatsvinden. Wanneer het geabonneerde evenement zich voordoet, zal Zonos een HTTP POST-verzoek sturen naar de webhook-URL die u opgeeft. De aanvraagbody bevat de details van het evenement, zodat uw systeem het evenement programmatisch kan afhandelen.

Webhooks zijn nuttig voor het integreren van Zonos met andere platforms, het triggeren van geautomatiseerde workflows en het in realtime synchroniseren van gegevens tussen systemen. U kunt bijvoorbeeld webhooks gebruiken om:

• Uw orderbeheersysteem bij te werken wanneer een bestelling wordt aangemaakt in Zonos
• Uw fulfilmentprovider te informeren wanneer een verzending wordt geannuleerd
• Statuswijzigingen van internationale bestellingen te loggen voor auditdoeleinden

Webhook-typen 

Alle beschikbare webhook-typen zijn opgenomen in de WebhookType enum. Voorbeeldpayloads voor elk type zijn te vinden in onze Evenementtypen handleiding.

Webhooks maken 

Om een webhook via de API te maken:

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

Bewerk webhook-gegevens 

Om een bestaande webhook via de API te bewerken:

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

Bekijk webhook-logboeken 

Om webhook-logboeken via de API te bekijken:

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