DOCS

Webhook

Ascolta gli eventi con i webhook

Ricevi notifiche di eventi in tempo reale per la tua integrazione Zonos.

I webhook forniscono a Zonos un modo per avvisare in modo proattivo i 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 specificato. Il corpo della richiesta conterrà i dettagli dell'evento, consentendo al sistema di gestire l'evento a livello di codice.

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:

  • Aggiorna il tuo sistema di gestione degli ordini quando viene creato un ordine in Zonos
  • Avvisare il fornitore di servizi logistici quando una spedizione viene annullata
  • Registrare i cambiamenti di stato degli ordini internazionali a fini di controllo

Tipi di webhook 

Tutti i tipi di webhook disponibili sono inclusi nel file WebhookType enum. I payload di esempio per ciascuno possono essere trovati nel nostro Tipi di eventi guida.

Creazione di webhook 

Per creare un webhook tramite API:

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

Modifica i dettagli del webhook 

Per modificare un webhook esistente tramite API:

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

Visualizza i log dei webhook 

Per visualizzare i log del webhook tramite 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

Questa pagina è stata utile?