Pazaryeri satıcısı için ne anlama gelir?
Bir satıcı en çok 15 webhook tanımlayabilir; bildirim “en az bir kez” ilkesiyle gelir, bu yüzden uç noktanız aynı olayı iki kez alabileceğini varsaymalıdır. Trendyol yine de sipariş paketlerini periyodik çekerek veriyi eşitlemenizi önerir.
Trendyol webhook servisi
- Kimlik doğrulama kullanıcı adı ve şifreyle (Basic) ya da x-api-key başlığıyla yapılır.
- Bildirim POST ve JSON olarak, siparişin durumundan bağımsız tam verisiyle gelir.
- Bildirim adresi “Trendyol”, “Dolap” ya da “Localhost” ifadesi içeremez.
- Hata sürerse webhook pasife alınır ve satıcıya e-posta gider; sorun düzelince yeniden etkinleştirilir.
Webhook imzası nasıl doğrulanır?
İmzalı webhook’ta gönderen ve alıcı ortak bir gizli anahtar paylaşır. Gönderen istek gövdesinin HMAC değerini hesaplayıp başlıkta yollar; alıcı aynı hesabı yapar ve değer tutmazsa isteği yok sayar. W3C WebSub önerisi bu başlığı X-Hub-Signature olarak tanımlar; HMAC’in kendisi IETF RFC 2104’te tanımlıdır.
Alıcı isteği aldığını hemen 2xx yanıtla bildirmeli, işi sonra kuyrukta yapmalıdır; aynı bildirim birden çok kez gelebileceği için aynı olayı iki kez işlememelidir.
Sık sorulan sorular
- Trendyol webhook’u imzalı mı?
- Trendyol belgesinde gövde imzası yoktur; kimlik Basic doğrulama ya da x-api-key ile doğrulanır.
- Webhook varsa ayrıca sorgu yapmak gerekir mi?
- Evet. Trendyol, webhook bildiriminin kaçabileceğini belirtir ve siparişlerin düzenli olarak sorgulanmasını da önerir.
- Webhook’a hangi yanıt verilmeli?
- Bildirim alındığında 2xx durum kodu. Yanıt işlemin bitmesini beklememelidir.
Kaynaklar
- Trendyol Developers — Webhook modeli (erişim: 15 Kasım 2026)
- W3C — WebSub (erişim: 15 Kasım 2026)
- IETF RFC 2104 — HMAC (erişim: 15 Kasım 2026)
- Trendyol Developers — Webhook model (erişim: 6 Kasım 2026)