Kapsamlar
| Kapsam | Ne zaman tetiklenir |
|---|---|
| store/order/created, store/order/updated | Sipariş oluştuğunda ya da güncellendiğinde |
| store/product/created, store/product/updated | Ürün oluştuğunda ya da güncellendiğinde |
| store/stock/created, store/stock/updated | Stok kaydı oluştuğunda ya da güncellendiğinde |
| store/customer/created, store/customer/updated | Müşteri hesabı oluştuğunda ya da güncellendiğinde |
| store/customerFavoriteProducts/created, .../updated | Favorilere ürün eklendiğinde ya da güncellendiğinde |
Kapsam listesi ikas'ın webhook referansından alındı (ikas: Webhook'lar). Stok senkronu için store/order/created ve store/stock/updated en işe yarayan ikilidir.
Aboneliği kurmak
- endpoint: bildirimin gideceği adres. ikas'a göre geçerli bir https adresi olmalıdır; düz http ve özel ya da ayrılmış IP aralıklarındaki adresler reddedilir.
- scopes: dinlenecek olayların listesi.
- salesChannelIds: isteğe bağlı; yalnız belirli satış kanallarının olaylarını almak için.
Kayıtlı abonelikler listWebhook ile görülür; deleteWebhook kapsam listesiyle aboneliği kaldırır. Admin uygulamaları için ikas, partner sayfasındaki App Webhook Url alanının doldurulmasını şart koşar. Aynı uç adres birden fazla kapsam için kullanılabilir; ikas SDK örneğinde gelen bildirim olay türüne göre ayrı işleyicilere yönlendirilir.
Teslim, deneme ve engelleme
| Kural | Değer |
|---|---|
| Başarılı teslim | Uç adres HTTP 200 döndürmeli |
| Başarısız teslim | 3 deneme, sonra gönderim durur |
| 15 dakika engelleme | Hata oranı yüzde 70 ve üzeri, 30 dakikada 10'dan fazla istek |
| 1 saat engelleme | Hata oranı yüzde 70 ve üzeri, 3 saatte 60'tan fazla istek |
| Kalıcı engelleme | Hata oranı yüzde 70 ve üzeri, 1 günde 240'tan fazla istek |
ikas, bildirimi aldığınızda önce 200 döndürüp işinizi ondan sonra çalıştırmanızı önerir. Ağır işleri bir kuyruğa bırakmak, uç adresin hızlı yanıt vermesini sağlar.
İmza doğrulama
ikas'ın SDK belgesi, gelen bildirimin imzasının uygulamanın client_secret değeriyle doğrulanmasını gösterir; @ikas/admin-api-client paketi bunun için hazır doğrulama fonksiyonları sunar (ikas SDK: Webhook). İmzası doğrulanamayan isteği işlemeyin.
Aynı olay birden fazla kez gelebileceği için işlediğiniz bildirimleri kaydedin. Webhook kaçırıldığında veri kaybolmasın diye, belirli aralıklarla listOrder ile kontrol okuması yapmak da iyi bir yedektir.
Sık sorulanlar
ikas webhook hangi olayları destekler?
Admin API referansına göre sipariş, ürün, stok, müşteri ve müşteri favorileri için created ve updated olayları; ör. store/order/created ve store/stock/updated.
ikas webhook adresim http olabilir mi?
Hayır. ikas geçerli bir https adresi ister; düz http ve özel IP aralıklarındaki adresler reddedilir.
Webhook adresim hata verirse ne olur?
ikas bildirimi üç kez dener, sonra gönderimi durdurur. Hata oranı yüksek kalırsa webhook'lar 15 dakikadan kalıcıya kadar engellenebilir.
Kayıtlı webhook'larımı nasıl görürüm?
listWebhook sorgusu uygulamanızın aktif webhook'larını endpoint ve scope alanlarıyla listeler. Bir aboneliği kaldırmak için deleteWebhook işlemine kapsam listesini verin.
Kaynaklar
İlgili ikas API konuları
Son güncelleme: 27.10.2026 · ikas API rehberinin tamamı