hikiehikieDeveloper Documentation
Nasıl çalışır

Abonelik durumları

active, paused ve failing — aboneliğiniz ne zaman durur, nasıl geri açılır.

Bir aboneliğin üç durumu var:

DurumAnlamıKim değiştirir
activeEventler gönderiliyorVarsayılan
pausedSiz duraklattınız; hiçbir şey gönderilmiyorSiz
failingÜst üste başarısızlıktan sonra sistem durdurduSistem
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şikGerekçe
Geçici (timeout, 5xx, ağ)5 ardışık teslimatHer 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 teslimatTekrar denemek anlamsız; alıcı isteği anlamıyor, haberiniz olmalı
Hedef adres reddedildi2 ardışık teslimatURL güvenlik kontrolünden geçmiyor; düzeltmeniz gerekiyor

failing olunca ne olur

  1. Abonelik durur — yeni eventler bu adrese gönderilmez.
  2. 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."
  3. 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.

Bu sayfada