الإشعارات الآلية للمطورين (Webhooks)
سجّل عنوان نقطة استقبال (HTTPS) ليصلك إشعار فور قبول الهيئة لإفصاح أو نشر تقرير XBRL الخاص به. الإشعارات تحمل بيانات عامة فقط، ويمكن تصفيتها حسب الشركة أو القطاع أو النموذج.
الدخول بالبريد الإلكتروني
التحقق من التوقيع ومنع إعادة الإرسال
كل طلب يحمل الترويسات X-FRA-Event و X-FRA-Delivery و X-FRA-Timestamp و X-FRA-Signature. احسب HMAC-SHA256 للنص «الطابع الزمني + نقطة + جسم الطلب» بمفتاح التوقيع وقارنه بالتوقيع، وارفض أي طلب طابعه الزمني أبعد من 5 دقائق، وتجاهل أي X-FRA-Delivery سبق استلامه. أعد الاستجابة 2xx خلال 10 ثوانٍ وإلا أعيدت المحاولة بعد 1 و5 و30 دقيقة ثم ساعتين و12 ساعة.
$expected = 'sha256=' . hash_hmac('sha256', $_SERVER['HTTP_X_FRA_TIMESTAMP'] . '.' . $rawBody, $secret);
$fresh = abs(time() - strtotime($_SERVER['HTTP_X_FRA_TIMESTAMP'])) <= 300;
$valid = $fresh && hash_equals($expected, $_SERVER['HTTP_X_FRA_SIGNATURE']);
// then: ignore if X-FRA-Delivery was already processed