Olaylar
| Olay | Gönderilme zamanı |
|---|---|
| client.created | Bir müşteri eklendiğinde. |
| order.submitted | Bir sipariş verildiğinde. |
| order.approved | Bir sipariş onaylandığında. |
| order.settled | Bir sipariş takas edilip paylar ihraç edildiğinde. |
| distribution.approved | Bir dağıtım onaylandığında. |
| transfer.completed | Yatırımcılar arasındaki bir devir tamamlandığında. |
| message.received | Bir müşteri mesaj gönderdiğinde. |
Yükler kimlikler, sayılar ve tutarlar içerir ancak kişisel veri içermez. Sisteminiz ayrıntıları bir API anahtarı ile çeker.
Uç nokta ekleme
- Ayarlar sayfasını, ardından Webhook’lar bölümünü açın ve Uç nokta ekle seçeneğini seçin.
- Birkaç saniye içinde 2xx durum koduyla yanıt veren bir
httpsadresi girin. Olayları seçin. - İmzalama gizli anahtarı değerini kopyalayın. Yalnızca bir kez gösterilir.
- Ulaşıp ulaşmadığını kontrol etmek için Test olayı gönder seçeneğini seçin.
- Yalnızca genel ana bilgisayarlardaki
httpsadresleri kabul edilir. Özel veya dahili ağları gösteren adresler reddedilir. - Yönlendirmeler takip edilmez.
İmzayı doğrulama
Her teslimat, EasyHaus-Event, EasyHaus-Delivery ve EasyHaus-Signature başlıklarını içeren bir JSON POST isteğidir. İmza t=<unix time>,v1=<hex> biçimindedir. <t>.<raw body> metninin gizli anahtarınızla HMAC-SHA256 değerini hesaplayın, v1 ile karşılaştırın ve eski zaman damgalarını reddedin.
Gövde {id, type, created_at, organization_id, data} biçimindedir.
Yeniden denemeler ve devre dışı bırakma
- 10 saniye içinde yanıt verin. Başarısız bir teslimat, giderek artan aralıklarla en fazla 10 kez yeniden denenir.
- Arka arkaya 20 başarısızlıktan sonra uç nokta devre dışı bırakılır ve sahiplere ve yöneticilere e-posta gönderilir. Sorunu giderin, ardından uç noktayı yeniden açın; bu, sayacı sıfırlar.
- Teslimat kaydı her teslimatı, durumunu ve HTTP kodunu gösterir ve yeniden teslim etmenize olanak tanır.
- Olayları düzenleyebilir, bir uç noktayı kapatabilir, gizli anahtarı yenileyebilir (eskisi hemen çalışmayı durdurur) veya uç noktayı silebilirsiniz.