İçeriğe geç
Webhook'lar

Webhook'lara Genel Bakış

Webhook'lar, farklı uygulamaların senkronize çalışabilmesi için uygulama içinde oluşan olayları entegre olmuş diğer uygulamalara bildiren bir teknolojidir. Mağazanızda belirli olaylar gerçekleştiğinde Ideasoft, API çağrısı yapmanıza gerek kalmadan kayıtlı adresinize HTTP POST bildirimi gönderir.

Yalnızca değişen alanlar gönderilir

Webhook gövdelerinde yalnızca değeri değişen alanlar gönderilir. Farklı verilere ihtiyacınız varsa bildirilen id ile ilgili API'ye istek atmanız gerekir.

Webhook kayıt özellikleri

Bir webhook kaydı aşağıdaki özelliklerden oluşur:

  • topic: Webhook'u tetikleyen olay.
  • address: Olay gerçekleştiğinde POST isteği gönderilen hedef URL.
  • status: Webhook durumu.
  • created_at: Webhook kaydının oluşturulma tarihi.
  • updated_at: Webhook kaydının güncellenme tarihi.

fields

fields özelliği (istekte hangi alanların dönmesini istediğiniz) V8'de kaldırılmıştır.

Desteklenen olaylar

15 varlık için create, update ve delete olayları tanımlıdır (bazı varlıklarda olay alt kümesi):

VarlıkTopik'ler
Marka (brand)brand/create, brand/update, brand/delete
Kategori (category)category/create, category/update, category/delete
Abonelik Sözleşmesi (contract)contract/create, contract/update, contract/delete
Ekstra Ayarlar (extra_pref)extra_pref/update
Üye (member)member/create, member/update, member/delete
Üye Grubu (member_group)member_group/create, member_group/update, member_group/delete
Sipariş (order)order/create, order/update, order/delete
Sipariş İade Talebi (order_refund_request)order_refund_request/create, order_refund_request/update, order_refund_request/delete
Ürün (product)product/create, product/update, product/delete
Ödeme (payment)payment/create, payment/update, payment/delete
Tema (theme)theme/create, theme/update, theme/delete
Kuyruk İşlemi (queue_process)queue_process/create, queue_process/update
Mail Listesi (maillist)maillist/create, maillist/update, maillist/delete
Para Birimi (currency)currency/update
Fiyat Kuralı (price_rule)price_rule/create, price_rule/update, price_rule/delete

Her topik varlık/olay biçimindedir; örneğin order/create veya product/update.

Alan listeleri

Her topik'in taşıdığı alanların güncel listesi için Webhook Referansı sayfasına bakın.

İstek zarfı

Gövde her zaman aynı zarf formatındadır:

JSONCode
{ "order/create": { "id": 1, "status": "..." }, "domain": "magaza-adiniz.myideasoft.com", "subDomain": "magaza-adiniz" }

delete topiklerinde gövde çoğunlukla yalnızca id içerir (birkaç konuda ek alanlar bulunur).

Devamı: Webhook Yönetimi · Güvenlik · Teslimat

Son güncelleme: