اشترك في file.submitted وfile.rejected وfile.approved. تُرسل المنصة كل تغيير في الحالة في أقل من ثانيتين مع توقيع HMAC-SHA256 وإعادة محاولات تلقائية.
هيّئ عنوان URL وجهة، ووقِّع بـ HMAC، واستقبل كل حدث بحمولة JSON منظَّمة. إعادة محاولات تلقائية مع تأخير تصاعدي.
POST /hooks
X-Booka-Signature: t=1713694331,v1=5257a869...
Content-Type: application/json
{
"id": "evt_9f8e...",
"type": "file.approved",
"data": {
"file_id": "file_abc123",
"regulator": "SCFHS",
"approved_at": "2026-04-21T10:32:11Z"
}
}import { verifyWebhook } from "@booka/sdk";
app.post("/hooks", (req, res) => {
const event = verifyWebhook(
req,
process.env.BOOKA_HOOK_SECRET
);
if (event.type === "file.approved") {
// sync to ATS / CRM
}
res.sendStatus(200);
});file.submitted وfile.approved وfile.rejected وverification.completed. كل حدث بحمولة JSON صارمة وإصدار.
كل طلب موقَّع بـ BOOKA_HOOK_SECRET الخاص بك. تحقق من التوقيع قبل المعالجة — SDK يفعل ذلك في سطر واحد.
إعادة محاولات تلقائية حتى 5 مرات مع تأخير تصاعدي. مهلة كل محاولة: 30 ثانية.
تُرسل المنصة الحدث في أقل من ثانيتين من تغيير الحالة لدى الجهة التنظيمية.
يُقبل فقط نقاط نهاية HTTPS بـ TLS 1.3. بلا استثناءات. يمنع كشف بيانات المرشحين أثناء الإرسال.
سجل 30 يومًا، تصفية حسب النوع، إعادة إرسال يدوي وسجلات أخطاء بحمولة خام للتصحيح.
TypeScript SDK مع verifyWebhook مدمج وعقود OpenAPI وsandbox بأحداث محاكاة. حالة حقيقية منذ الملف الأول.
Sandbox مجاني · TypeScript SDK · HMAC-SHA256 · TLS 1.3 إلزامي