test.ping
Panelden gönderilen test eventi — entegrasyonu gerçek bir sipariş beklemeden doğrulamak için.
test.ping, panelde abonelik satırındaki Test gönder düğmesine
bastığınızda gönderilir. Amacı tüm zinciri gerçek bir sipariş beklemeden
denemek: adres doğru mu, sertifika geçerli mi, imzayı doğrulayabiliyor musunuz,
zamanında yanıt dönüyor musunuz.
{
"subscriptionId": "66b2c1a70f5e8d4319ab72c6",
"message": "Hikie webhook bağlantınız çalışıyor.",
"dateSent": "2026-08-07T09:20:00.000Z"
}Alan
Tip
Bilinmesi gerekenler
test.ping, aboneliğin dinlediği event listesinden bağımsız olarak
gönderilir. Listede seçmeniz gerekmez — hatta seçenekler arasında görünmez.
- Gerçek bir teslimattır. İmzalanır, yeniden deneme kurallarına tabidir ve Teslimat geçmişinde diğer eventlerle birlikte görünür.
- Başarısız olursa sayılır. Test teslimatları da abonelik başarısızlık
sayacına katkı yapar; art arda başarısız testler aboneliği
failingdurumuna düşürebilir. - İş yaptırmaz. Payload'ında sipariş, ürün ya da kullanıcı verisi yoktur.
İşleyicinizde ele almak
test.ping için iş mantığı çalıştırmayın; sadece loglayın.
switch (eventType) {
case 'test.ping':
console.log(`[hikie] test bağlantısı başarılı — ${payload.message}`);
return; // iş yok
case 'order.paid':
return grantPurchase(payload);
// …
}test.ping'i default dalına düşürüp hata dönmeyin. 400 dönerseniz panelde
test başarısız görünür ve aboneliğiniz gereksiz yere başarısızlık sayacı
biriktirir.
Ne zaman kullanmalı
İlk kurulumda
Aboneliği oluşturduktan hemen sonra, gerçek eventleri beklemeden zinciri doğrulamak için.
URL değiştirdiğinizde
Yeni adresin gerçekten ulaşılabilir olduğunu görmek için.
Secret'ı yeniledikten sonra
Sunucunuzdaki yeni değerin doğru yüklendiğini doğrulamak için.
failing durumundan çıkarken
Sorunu düzelttikten sonra, gerçek bir event beklemeden test etmek için.
Sonucu nerede görürsünüz
Panelde abonelik satırından Teslimat geçmişi:
| Görünen | Anlamı |
|---|---|
delivered, 200, 43 ms | Her şey yolunda |
exhausted, timeout | Sunucunuz 5 saniyede yanıt dönmedi |
exhausted, http_4xx, 400 | İmza doğrulamanız reddetti |
exhausted, tls | Sertifika sorunu |
exhausted, dns | Adres çözümlenemedi |
exhausted, blocked_* | Adres güvenlik kontrolünden geçmedi |
Her durum için çözüm: Hata ayıklama.