Dengarkan peristiwa dengan webhook

Webhook menyediakan cara bagi Zonos untuk secara proaktif memberi tahu sistem eksternal Anda setiap kali peristiwa tertentu terjadi. Ketika peristiwa yang disubscribe terjadi, Zonos akan mengirimkan permintaan HTTP POST ke URL webhook yang Anda tentukan. Badan permintaan akan berisi rincian peristiwa, memungkinkan sistem Anda untuk menangani peristiwa tersebut secara programatis.

Webhook berguna untuk mengintegrasikan Zonos dengan platform lain, memicu alur kerja otomatis, dan menjaga data tetap sinkron di seluruh sistem secara waktu nyata. Misalnya, Anda dapat menggunakan webhook untuk:

• Memperbarui sistem manajemen pesanan Anda ketika pesanan dibuat di Zonos
• Memberi tahu penyedia pemenuhan Anda ketika pengiriman dibatalkan
• Mencatat perubahan status pesanan internasional untuk tujuan audit

Jenis webhook 

Semua jenis webhook yang tersedia termasuk dalam enum WebhookType. Contoh payload untuk masing-masing dapat ditemukan dalam panduan Jenis Peristiwa.

Membuat webhook 

Untuk membuat webhook melalui API:

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

Edit detail webhook 

Untuk mengedit webhook yang ada melalui API:

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

Lihat log webhook 

Untuk melihat log webhook melalui API:

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