DOCS

Webhooks

/

Webhook'lar ile olayları dinleyin

Zonos entegrasyonunuz için gerçek zamanlı olay bildirimleri alın.

Webhook'lar, Zonos'un belirli olaylar gerçekleştiğinde dış sistemlerinizi proaktif olarak bilgilendirmesini sağlayan bir yol sunar. Abone olduğunuz olay gerçekleştiğinde, Zonos belirttiğiniz webhook URL'sine bir HTTP POST isteği gönderir. İstek gövdesi, olay detaylarını içerecek ve sisteminizin olayı programatik olarak işlemesine olanak tanıyacaktır.

Webhook'lar, Zonos'u diğer platformlarla entegre etmek, otomatik iş akışlarını tetiklemek ve sistemler arasında verileri gerçek zamanlı olarak senkronize tutmak için faydalıdır. Örneğin, webhook'ları kullanarak:

  • Zonos'da bir sipariş oluşturulduğunda sipariş yönetim sisteminizi güncelleyebilirsiniz
  • Bir gönderim iptal edildiğinde yerine getirme sağlayıcınızı bilgilendirebilirsiniz
  • Uluslararası siparişlerin durum değişikliklerini denetim amaçları için kaydedebilirsiniz

Webhook türleri 

Tüm mevcut webhook türleri WebhookType enum'unda bulunmaktadır. Her biri için örnek yükler, Olay Türleri kılavuzumuzda bulunabilir.

Webhook oluşturma 

API aracılığıyla bir webhook oluşturmak için:

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

Webhook ayrıntılarını düzenle 

API aracılığıyla mevcut bir webhook'u düzenlemek için:

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

Webhook günlüklerini görüntüle 

Webhook günlüklerini API aracılığıyla görüntülemek için:

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

Bu sayfa yardımcı oldu mu?