DOCS

Webhooks

/

Ascolta gli eventi con i webhook

Ricevi notifiche in tempo reale per la tua integrazione con Zonos.

I webhook forniscono un modo per Zonos di notificare proattivamente i tuoi sistemi esterni ogni volta che si verificano determinati eventi. Quando si verifica l'evento sottoscritto, Zonos invierà una richiesta HTTP POST all'URL del webhook che specifichi. Il corpo della richiesta conterrà i dettagli dell'evento, consentendo al tuo sistema di gestire l'evento in modo programmatico.

I webhook sono utili per integrare Zonos con altre piattaforme, attivare flussi di lavoro automatizzati e mantenere i dati sincronizzati tra i sistemi in tempo reale. Ad esempio, potresti utilizzare i webhook per:

  • Aggiornare il tuo sistema di gestione degli ordini quando un ordine viene creato in Zonos
  • Notificare il tuo fornitore di evasione quando una spedizione viene annullata
  • Registrare le modifiche di stato degli ordini internazionali per scopi di audit

Tipi di webhook 

Tutti i tipi di webhook disponibili sono inclusi nell'enum WebhookType. Esempi di payload per ciascuno possono essere trovati nella nostra guida Tipi di Evento.

Creazione di webhook 

Per creare un webhook tramite l'API:

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
mutation {
  webhookCreate(
    input: {
      url: "https://example.com/webhooks/zonos"
      type: ORDER_CREATED
      status: ENABLED
    }
  ) {
    id
    url
    type
    status
  }
}

Modifica i dettagli del webhook 

Per modificare un webhook esistente tramite l'API:

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
mutation {
  webhookUpdate(
    input: {
      id: "webhook-id"
      url: "https://example.com/webhooks/zonos"
      type: ORDER_CREATED
      status: ENABLED
    }
  ) {
    id
    url
    type
    status
  }
}

Visualizza i registri dei webhook 

Per visualizzare i registri dei webhook tramite l'API:

GraphQL

1
2
3
4
5
6
7
8
9
10
11
12
13
query {
  webhookLogs(first: 20, after: "yyyyyyy", filter: { type: ORDER_CREATED }) {
    edges {
      node {
        id
        type
        url
        createdAt
        responseStatus
      }
    }
  }
}

Questa pagina è stata utile?