Abonelik durumları
active, paused ve failing — aboneliğiniz ne zaman durur, nasıl geri açılır.
Bir aboneliğin üç durumu var:
| Durum | Anlamı | Kim değiştirir |
|---|---|---|
active | Eventler gönderiliyor | Varsayılan |
paused | Siz duraklattınız; hiçbir şey gönderilmiyor | Siz |
failing | Üst üste başarısızlıktan sonra sistem durdurdu | Sistem |
stateDiagram-v2
[*] --> active: abonelik oluşturuldu
active --> paused: siz duraklattınız
paused --> active: siz devam ettirdiniz
active --> failing: eşik aşıldı
failing --> active: başarılı teslimat (otomatik)
failing --> paused: siz duraklattınız
active --> [*]: sildiniz
failing ne zaman olur
Aboneliğin consecutiveFailureCount sayacı, tamamen başarısız olan her
teslimatta artar; başarılı ilk teslimatta sıfırlanır.
Bir teslimatın "başarısız" sayılması, geçici hatalarda 72 saatlik pencerenin tümünü tüketmesi demektir — yani 10 denemenin hepsi başarısız olmuştur. Bu yüzden geçici hatalarda eşik yüksek tutulabiliyor.
| Hata türü | Eşik | Gerekçe |
|---|---|---|
| Geçici (timeout, 5xx, ağ) | 5 ardışık teslimat | Her biri zaten 72 saat boyunca denendi; sunucu gerçekten uzun süredir yok |
| Kalıcı (400, 401, 403, 404, 410, 422, 3xx) | 2 ardışık teslimat | Tekrar denemek anlamsız; alıcı isteği anlamıyor, haberiniz olmalı |
| Hedef adres reddedildi | 2 ardışık teslimat | URL güvenlik kontrolünden geçmiyor; düzeltmeniz gerekiyor |
failing olunca ne olur
- Abonelik durur — yeni eventler bu adrese gönderilmez.
- Panelde abonelik kırmızı görünür ve nedeni yazar, örneğin:
- "Alıcı 404 döndüğü için 2 teslimat üst üste kalıcı olarak başarısız oldu."
- "5 teslimat üst üste tüm deneme haklarını tüketti (son hata: timeout)."
- "Hedef adres güvenlik kontrolünden geçmedi: Yalnızca HTTPS adresleri desteklenir."
- Hesabınıza uygulama içi bildirim düşer.
failing durumundayken üretilen eventler birikmez. Abonelik yeniden
aktifleştiğinde geçmişe dönük teslimat yapılmaz — o aradaki eventler
kaçırılmıştır. Bu yüzden bildirimi görünce hızlı davranın.
Nasıl geri açılır
Otomatik: Sorunu düzelttikten sonra bir sonraki başarılı teslimat
aboneliği kendiliğinden active yapar. Elle bir şey yapmanız gerekmez.
Ama failing durumundayken yeni teslimat açılmadığı için, otomatik dönüşün
tetiklenmesi bir teslimat denemesi gerektirir. Pratikte akış şudur:
Nedeni okuyun
Panelde abonelik satırındaki durum açıklaması ve Teslimat geçmişi.
Sorunu düzeltin
404 ise yolu, timeout ise yanıt sürenizi, tls ise sertifikanızı.
URL değiştiyse abonelikteki adresi güncelleyin.
Devam ettirin
Abonelik satırından Devam ettir deyin — durum active'e döner.
Test gönderin
Test gönder ile bir test.ping yollayın. Başarılı olursa entegrasyon
gerçekten çalışıyordur.
paused — siz duraklattığınızda
Bakım yapacaksanız ya da entegrasyonu geçici olarak kapatmak istiyorsanız aboneliği duraklatın. Duraklatma:
- Yeni eventlerin gönderilmesini durdurur.
- Bekleyen teslimatları da iptal eder (
cancelled) — 72 saat sonra sürpriz bir bildirim gitmez. - Aboneliği ve secret'ı silmez; devam ettirdiğinizde aynı secret geçerlidir.
Aboneliği silmek
Silme kalıcıdır:
- Abonelik ve secret'ı gider.
- Bekleyen tüm teslimatlar iptal edilir.
- Aynı URL'yi yeniden ekleyebilirsiniz, ama yeni bir secret alırsınız.
Aynı URL'yi bir hesapta iki kez ekleyemezsiniz. Farklı event grupları için
ayrı abonelikler istiyorsanız farklı yollar kullanın:
/hikie/orders ve /hikie/products gibi.