DOCS

Webhooks

Écouter les événements avec les webhooks

Recevez des notifications d'événements en temps réel pour votre intégration Zonos.

Les webhooks permettent à Zonos de notifier proactivement vos systèmes externes lorsque certains événements se produisent. Lorsque l'événement souscrit se produit, Zonos envoie une requête HTTP POST à l'URL webhook que vous spécifiez. Le corps de la requête contiendra les détails de l'événement, permettant à votre système de le traiter par programmation.

Les webhooks sont utiles pour intégrer Zonos avec d'autres plateformes, déclencher des flux de travail automatisés et maintenir la synchronisation des données entre systèmes en temps réel. Par exemple, vous pourriez utiliser les webhooks pour :

  • Mettre à jour votre système de gestion des commandes lorsqu'une commande est créée dans Zonos
  • Notifier votre prestataire de fulfillment lorsqu'un envoi est annulé
  • Enregistrer les changements de statut des commandes internationales à des fins d'audit

Types de webhooks 

Tous les types de webhooks disponibles sont inclus dans l'énumération WebhookType. Des exemples de payload pour chacun se trouvent dans notre guide Types d'événements.

Créer des webhooks 

Pour créer un webhook via l'API :

1mutation WebhookCreate($input: WebhookCreateInput!) {
2 webhookCreate(input: $input) {
3 id
4 url
5 type
6 status
7 }
8}

Modifier les détails d'un webhook 

Pour modifier un webhook existant via l'API :

1mutation WebhookUpdate($input: WebhookUpdateInput!) {
2 webhookUpdate(input: $input) {
3 id
4 url
5 type
6 status
7 }
8}

Consulter les journaux de webhooks 

Pour consulter les journaux de webhooks via l'API :

1query WebhookLogs(
2$first: Int
3$after: String
4$filter: WebhookLogsFilterInput
5) {
6 webhookLogs(first: $first, after: $after, filter: $filter) {
7 edges {
8 node {
9 id
10 type
11 url
12 createdAt
13 responseStatus
14 }
15 }
16 }
17}
GraphQL API ReferenceTypes, inputs, and operations used in this guide

Cette page a-t-elle été utile?