DOCS

Webhooks

Lắng nghe các sự kiện bằng webhooks

Nhận thông báo sự kiện thời gian thực cho tích hợp Zonos của bạn.

Webhooks cung cấp một cách để Zonos chủ động thông báo cho các hệ thống bên ngoài của bạn bất cứ khi nào các sự kiện nhất định xảy ra. Khi sự kiện được đăng ký xảy ra, Zonos sẽ gửi một yêu cầu HTTP POST đến URL webhook bạn chỉ định. Phần thân của yêu cầu sẽ chứa chi tiết sự kiện, cho phép hệ thống của bạn xử lý sự kiện theo chương trình.

Webhooks rất hữu ích cho việc tích hợp Zonos với các nền tảng khác, kích hoạt các quy trình công việc tự động và giữ dữ liệu được đồng bộ hóa trên các hệ thống theo thời gian thực. Ví dụ: bạn có thể sử dụng webhooks để:

  • Cập nhật hệ thống quản lý đơn hàng của bạn khi tạo đơn hàng trong Zonos
  • Thông báo cho nhà cung cấp thực hiện khi hủy lô hàng
  • Ghi lại các thay đổi trạng thái của các đơn hàng quốc tế cho mục đích kiểm toán

Các loại webhook 

Tất cả các loại webhook có sẵn được bao gồm trong enum WebhookType. Các ví dụ về payload cho mỗi loại có thể được tìm thấy trong hướng dẫn Các Loại Sự Kiện của chúng tôi.

Tạo webhooks 

Để tạo webhook qua API:

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

Chỉnh sửa chi tiết webhook 

Để chỉnh sửa webhook hiện có qua API:

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

Xem nhật ký webhook 

Để xem nhật ký webhook qua 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

Trang này có hữu ích không?