Neden webhook?
Webhook olmadan siparişleri düzenli aralıklarla okursunuz. Bu aralık beş dakikaysa, yeni bir sipariş ortalama birkaç dakika boyunca diğer kanallarda stok düşürmeden bekler. Çok satan bir üründe bu süre çift satışa yeter.
| Yöntem | Gecikme | Yük | Kaçırma riski |
|---|---|---|---|
| Yalnız düzenli okuma | Okuma aralığı kadar | Her turda tüm listeler | Düşük |
| Yalnız webhook | Saniyeler | Yalnız olay olunca | Bildirim kaybolursa yüksek |
| İkisi birlikte | Saniyeler | Düşük | Düşük |
En sağlam düzen ikisini birlikte kullanmaktır: webhook hızı sağlar, düzenli okuma kaybolan bildirimleri yakalar.
Alıcı adresi nasıl kurulur?
- Herkese açık bir https adresi hazırlayın.
- Aynı adreste hem POST hem PUT isteğini kabul edin. PUT kabul etmeyen bir alıcı paket bozma olaylarını hiç görmez.
- Her mağaza için ayrı bir adres ya da adreste mağazayı tanıtan bir parça kullanın; çok mağazalı bir sistemde bildirimin hangi mağazaya ait olduğu adresten anlaşılsın.
- Adrese tahmin edilemeyen bir gizli değer ekleyin ve her istekte doğrulayın.
Bildirim adresinin Hepsiburada tarafında nasıl tanımlanacağı için geliştirici portalını kontrol edin. Test ve canlı ortam için adresleri ayrı tanımlayın.
İsteği doğrulamak ve işlemek
Webhook adresi internete açıktır; herkes istek gönderebilir. Bu yüzden her isteği doğrulayın:
- Adresteki gizli değeri sabit sürede karşılaştıran bir işlevle kontrol edin; düz eşitlik karşılaştırması zamanlama saldırısına açıktır.
- Doğrulanmayan isteğe 401 dönün ve gövdesini saklamayın; yalnız zamanı ve kısa bir nedeni kaydedin.
- Doğrulanan isteği kaydedin, sonra işleyin.
- Uzun işleri arka plana bırakın ve hızlıca 200 dönün. Alıcı geç yanıt verirse gönderen taraf isteği başarısız sayabilir.
Bildirimi tek doğru kaynak saymayın. Bildirimi bir "tetikleyici" gibi kullanıp asıl veriyi API'den okumak, eksik ya da sırası karışmış bildirimlerin zararını sıfırlar.
Bildirim geldiğinde ne yapılmalı?
| Olay | Yapılacak iş |
|---|---|
| CreateOrder | Siparişleri hemen okuyun, stoğu düşürün |
| OrderCancel | İptali işleyin, düşülen stoğu geri ekleyin |
| Undeliver | Teslim edilemeyen paketi işleyin |
| Intransit, Deliver | Sipariş durumunu güncelleyin |
| CreatePackages | Paket numarasını alın |
| ChangeShippingAddress | Adresi detaydan yeniden okuyun |
| Unpack (PUT) | Kalemleri yeniden paketlenecek sayın |
Olayların tanınması ve gövdedeki ipuçları webhook olay tipleri sayfasında.
Sık hatalar ve çözümleri
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Paket bozma olayları gelmiyor | Alıcı PUT kabul etmiyor | Aynı adreste PUT isteğini kabul edin |
| Sahte istekler işleniyor | Gizli değer doğrulanmıyor | Her istekte gizli değeri doğrulayın |
| Bildirimler kayboluyor | Alıcı geç yanıt veriyor | Hızlıca 200 dönüp işi arka plana bırakın |
| Stok iki kez düştü | Bildirim ve düzenli okuma aynı siparişi iki kez işledi | İşlenen siparişleri kaydedip tekilleştirin |
Sık sorulanlar
Hepsiburada webhook gönderir mi?
Evet. Yeni sipariş, iptal, kargo, teslim, paket ve adres değişikliği gibi sipariş olaylarını belirlediğiniz adrese gönderir.
Webhook adresim hangi yöntemleri kabul etmeli?
POST ve PUT. Paket bozma (Unpack) bildirimi PUT ile gelir.
Webhook varken düzenli okumaya gerek var mı?
Evet. Bildirim kaybolabilir; düzenli okuma kaçanları yakalar. İkisi birlikte en sağlam düzendir.
Bildirimin sahte olmadığını nasıl anlarım?
Adrese tahmin edilemeyen bir gizli değer ekleyip her istekte sabit sürede doğrulayın. Doğrulanmayan isteğe 401 dönün.
Kaynaklar
İlgili Hepsiburada API konuları
Son güncelleme: 27.10.2026 · Hepsiburada API rehberinin tamamı