Webhooks entegrasyonu

Webhook entegrasyonuyla sipariş, stok, fiyat, iade ve kargo olayları uç noktanıza imzalı olarak gönderilir. Kendi sistemleriniz Yekuna olaylarına sorgulama yapmadan tepki verir.

Ücretsiz deneyin Demo talep edin

Kredi kartı istenmez · deneme ilk mağazanızı bağladığınızda başlar.

Güncellendi: 6 Kasım 2026

Webhooks

Tek panel

Olay yayını
İmzalı teslim
Yeniden deneme

Webhooks ile Yekuna arasında Olay yayını, İmzalı teslim, Yeniden deneme akışı tek panelden yönetilir.

Ne işe yarar

Webhook, “olay oldu, işte veri” der: sürekli sorgulamaya, gecikmeye ve boşa giden isteğe gerek kalmaz. Kendi iç aracını, deposunu ya da bildirimini tetiklemek isteyen teknik ekipler için uygun bir yoldur.

Uç noktanız ve dinlenecek olaylar tanımlanır. Teslimatlar imzalı gönderilir, başarısız olanlar yeniden denenir. Abonelik, olay seçimi ve gizli anahtar yenileme Yekuna API üzerinden yönetilir.

Yekuna, pazaryeri entegrasyonu ve e-ticaret operasyon panelidir. Trendyol, Hepsiburada, n11, kendi siteniz, stok ve siparişler tek panelden yönetilir.

Kurulum

Webhooks nasıl bağlanır?

Olayları alacak HTTPS uç noktanız hazırlanır; uç nokta başarılı aldığı isteğe 2xx koduyla yanıt vermelidir.
Yekuna API’de webhooks:write kapsamlı anahtarla abonelik oluşturulur; GET /v1/webhooks/topics olay listesini verir, abonelikte yalnız ihtiyacınız olan olaylar seçilir.
Abonelik oluşturulurken verilen gizli anahtar saklanır; imza doğrulaması ve eventId ile tekilleştirme uç noktanızda kurulur.
Test siparişiyle order.created olayının ulaştığı ve imzanın doğrulandığı kontrol edilir.

Kapsam

Yekuna ile hangi operasyonlar yönetilir?

İmzalı teslim
Her olay doğrulanabilir imzayla gider.
Yeniden deneme
Ulaşmayan olay kaybolmaz, kuyrukta tekrar denenir.
Olay seçimi
Yalnızca ihtiyacınız olan olaylara abone olursunuz.

Senaryolar

Gerçek kullanımda

Depo için kendi ekran sisteminizi kurmak

Örnek Mağaza’nın teknik ekibi depodaki büyük ekranda canlı sipariş akışını gösteren bir araç yazabilir. Veri kaynağı Yekuna webhook’larıdır.

Başlangıç

Webhooks operasyonunuzu Yekuna ile tek panele taşıyın

Ücretsiz deneyin

SSS

Sık sorulanlar

Webhook imzasını nasıl doğrularım?: Her teslimat gizli anahtarınızla imzalanır. İmza X-Yekuna-Signature başlığında v1= önekiyle, zaman damgası X-Yekuna-Timestamp başlığında gelir; “zaman damgası.gövde” metninin HMAC-SHA256 özetini hesaplayıp karşılaştırırsınız.
Webhook uç noktam geçici olarak düşerse olaylar kaybolur mu?: Hayır. Teslim edilemeyen olaylar kuyrukta bekler ve artan aralıklarla yeniden denenir.
Hangi olaylara abone olabilirim?: Sipariş oluşturma ve durum değişikliği, stok bakiyesi değişikliği, fiyat kararı, iade talebi ve iade kararı, kargo durumu, komut sonucu ve otomasyon olayları. Her olay ilgili okuma kapsamını ister; örneğin sipariş olayları orders:read gerektirir.
Aynı olay iki kez gelebilir mi?: Evet. Teslim sözleşmesi en az bir kezdir; ağ zaman aşımında aynı olay aynı eventId ile yeniden gönderilebilir. Uç noktanız olayları eventId ile tekilleştirmelidir.

İlgili