DOCS

Webhooks

/

웹훅으로 이벤트 수신하기

Zonos 통합을 위한 실시간 이벤트 알림을 받으세요.

웹훅은 Zonos가 특정 이벤트가 발생할 때마다 외부 시스템에 사전 알림을 제공하는 방법입니다. 구독한 이벤트가 발생하면, Zonos는 지정한 웹훅 URL로 HTTP POST 요청을 보냅니다. 요청 본문에는 이벤트 세부 정보가 포함되어 있어, 귀하의 시스템이 프로그래밍 방식으로 이벤트를 처리할 수 있습니다.

웹훅은 Zonos를 다른 플랫폼과 통합하고, 자동화된 워크플로를 트리거하며, 시스템 간의 데이터를 실시간으로 동기화하는 데 유용합니다. 예를 들어, 웹훅을 사용하여:

  • Zonos에서 주문이 생성될 때 주문 관리 시스템을 업데이트
  • 배송이 취소될 때 이행 제공자에게 알림
  • 감사 목적으로 국제 주문의 상태 변경 로그 기록

웹훅 유형 

사용 가능한 모든 웹훅 유형은 WebhookType 열거형에 포함되어 있습니다. 각 유형에 대한 예제 페이로드는 이벤트 유형 가이드에서 확인할 수 있습니다.

웹훅 생성 

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
  }
}

웹훅 세부정보 편집 

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
  }
}

웹훅 로그 보기 

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
      }
    }
  }
}

이 페이지가 도움이 되었습니까?


질문 있으세요?

문의하세요.

Zonos을 보세요

정책 및 계약
이 페이지에서: