Bulbulustur Geliştirici

Webhook Oluşturma V1

Mağazanız için imzalı webhook aboneliği oluşturma.

Abonelik Oluşturma

POST /api/webhooks

POST /api/webhooks işlemi yalnızca kimliği doğrulanan mağazaya ait abonelik oluşturur. Başlıklarda X-Api-Key ve X-Api-Secret gereklidir.

{
  "url": "https://your-domain.example/webhook",
  "eventTypes": ["order.created", "return.created"]
}

url genel internete açık HTTPS adresi olmalıdır; yerel ağ, loopback ve özel IP hedefleri kabul edilmez. Olay türleri order.created, order.updated, return.created, return.updated veya hepsi için * olabilir.

Mağaza başına en fazla 5 abonelik oluşturulur. İstek gövdesinde mağaza ID'si veya imza anahtarı gönderilmez. Başarılı yanıt: Result<WebhookSubscription>. signingSecret yalnızca oluşturma yanıtında döner; güvenli saklayın.

Sandbox anahtarıyla oluşturulan abonelikler yalnızca test bildirimi alır. Endpoint aboneliği oluşturur; otomatik sipariş/iade olaylarının üretimini tek başına başlatmaz.