hikiehikieDeveloper Documentation
Nasıl çalışır

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

DurumNeden
Aboneliğiniz pausedSiz 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ğilAbonelikte yalnızca seçtiğiniz tipler gönderilir
Olay zaten işlenmiştiAynı 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.

Bu sayfada