الأحداث
| الحدث | يُرسل عندما |
|---|---|
| client.created | يُضاف عميل. |
| order.submitted | يُقدَّم أمر. |
| order.approved | تتم الموافقة على أمر. |
| order.settled | يُسوّى أمر وتُصدر حصص. |
| distribution.approved | يُعتمد توزيع. |
| transfer.completed | يكتمل تحويل بين مستثمرين. |
| message.received | يرسل عميل رسالة. |
تحمل البيانات المرسلة المعرّفات والأرقام والمبالغ، لكن دون بيانات شخصية. يجلب نظامك التفاصيل باستخدام مفتاح API.
إضافة نقطة نهاية
- افتح الإعدادات ثم Webhooks، واختر إضافة نقطة نهاية.
- أدخل عنوان
httpsيستجيب بحالة 2xx خلال بضع ثوانٍ. اختر الأحداث. - انسخ سر التوقيع. يُعرض مرة واحدة.
- اختر إرسال حدث تجريبي للتحقق من وصوله.
- تُقبَل عناوين
httpsعلى مضيفين عامين فقط. تُرفض العناوين التي تشير إلى شبكات خاصة أو داخلية. - لا تُتبع عمليات إعادة التوجيه.
التحقق من التوقيع
كل إرسال هو POST بصيغة JSON مع الترويسات EasyHaus-Event وEasyHaus-Delivery وEasyHaus-Signature. يبدو التوقيع مثل t=<unix time>,v1=<hex>. احسب HMAC-SHA256 للنص <t>.<raw body> بسرك، وقارنه بـ v1، وارفض الطوابع الزمنية القديمة.
المتن هو {id, type, created_at, organization_id, data}.
إعادة المحاولة والتعطيل
- استجب خلال 10 ثوانٍ. يُعاد الإرسال الفاشل بتأخيرات متزايدة، حتى 10 محاولات.
- بعد 20 إخفاقًا متتاليًا تُعطَّل نقطة النهاية ويتلقى المالكون والمسؤولون رسالة. أصلحها ثم فعّلها مجددًا لإعادة ضبط العدد.
- يعرض سجل التسليم كل إرسال وحالته ورمز HTTP، ويتيح إعادة الإرسال.
- يمكنك تعديل الأحداث أو تعطيل نقطة نهاية أو تدوير السر (يتوقف القديم فورًا) أو حذفها.