Genel akış
Bir olay gerçekleştiği andan sunucunuza istek düşene kadar ne oluyor.
Bir sipariş ödendiğinde arka planda şunlar olur:
flowchart TD
A["Mağazanızda olay gerçekleşir<br/>örn. ödeme tamamlanır"] --> B["hikie olayı kaydeder<br/>tekrar kontrolü burada yapılır"]
B --> C{"Bu olayı dinleyen<br/>aktif aboneliğiniz var mı?"}
C -->|"hayır"| Z["Hiçbir şey gönderilmez"]
C -->|"evet"| D["Her abonelik için<br/>ayrı bir teslimat açılır"]
D --> E["Gövde hazırlanır ve<br/>secret'ınızla imzalanır"]
E --> F["Sunucunuza POST"]
F -->|"2xx"| G["delivered"]
F -->|"geçici hata"| H["retrying<br/>sıradaki denemeye kadar bekler"]
H --> E
F -->|"kalıcı hata"| I["exhausted"]
Adım adım
Olay kaydedilir
hikie olayı önce kendi tarafında kaydeder. Bu kayıt aynı zamanda tekrar filtresidir: ödeme sağlayıcısı aynı siparişi iki farklı yoldan bildirirse (bu sık olur — hem tarayıcı dönüşü hem sunucu bildirimi), ikinci bildirim burada durur ve size ikinci bir istek gitmez.
Abonelikleriniz eşleştirilir
Yalnızca o olay tipini dinleyen ve durumu active olan abonelikler
alınır. paused ve failing abonelikler atlanır.
Aynı olayı birden fazla aboneliğiniz dinliyorsa her biri için ayrı bir teslimat açılır — biri başarısız olsa diğerleri etkilenmez, her birinin kendi yeniden deneme zinciri olur.
Gövde imzalanır
Gövde bir kez üretilir ve secret'ınızla imzalanır. Aynı gövde tüm yeniden denemelerde bayt bayt aynı kalır; değişen tek şey imza ve zaman damgasıdır, onlar da başlıklarda taşınır.
Bu, isterseniz gövdeyi hash'leyip karşılaştırmanıza imkân verir.
İstek gönderilir
POST, 5 saniye zaman aşımı, yönlendirme takibi kapalı. Yanıtınız 2xx ise
teslimat tamamdır. Değilse yeniden deneme
zinciri başlar.
Bir olay, birden fazla abonelik
flowchart LR
E["order.paid"] --> D1["Teslimat #1<br/>api.siteniz.com/hook"]
E --> D2["Teslimat #2<br/>crm.sirketiniz.com/hikie"]
E --> D3["Teslimat #3<br/>discord-bot.example/notify"]
D1 --> R1["delivered"]
D2 --> R2["retrying"]
D3 --> R3["delivered"]
Her teslimatın kendi Hikie-Webhook-Idsi, kendi deneme sayacı ve kendi
geçmişi vardır. Bir hedefin cevap vermemesi diğerlerini yavaşlatmaz.
Ne zaman hiç istek gelmez
| Durum | Neden |
|---|---|
Aboneliğiniz paused | Siz duraklattınız |
Aboneliğiniz failing | Üst üste başarısızlıktan sonra sistem duraklattı — bkz. Abonelik durumları |
| Olay tipi abonelikte seçili değil | Abonelikte yalnızca seçtiğiniz tipler gönderilir |
| Olay zaten işlenmişti | Aynı olay ikinci kez tetiklendi ve tekrar filtresine takıldı |
| Olayın tetiklendiği koşul oluşmadı | Örn. order.shipmentUpdated yalnızca siparişin kargo/iade durumu gerçekten değiştiğinde üretilir |
Sıralama garantisi yok
Olaylar üretildikleri sırayla gönderilmeye çalışılır, ama sıra garanti edilmez. Bir teslimat yeniden denemeye düşerse, ondan sonra üretilen bir olay ona yetişebilir.
Pratikte bu şu anlama gelir: Fulfilled durumu için bir order.shipmentUpdated,
ilk teslimat denemesi yeniden denendiyse CargoDelivered durumu için olandan
sonra elinize geçebilir. Kendi tarafınızda sıralamayı
Hikie-Occurred-At başlığına göre yapın:
const occurredAt = new Date(req.get('Hikie-Occurred-At'));
if (occurredAt <= kaydedilenSonDurum.occurredAt) {
return; // daha eski bir olay, atla
}Ayrıntı: Tekrarları yönetmek.