دليل تكامل مصادقة للجهات المستفيدة

١. طلب الوصول للبيئة التجريبية

افتح نموذج التواصل واختر «المنتجات والحلول» ← مصادقة، وصف النظام الذي تريد ربطه (منصة موارد بشرية، نظام قبول، نظام تراخيص، إلخ). يردّ فريق التكامل خلال يومَي عمل ببيانات الدخول ومواصفات الواجهات البرمجية.

٢. تنفيذ نداء التحقق

استخدم نقطة النهاية `POST /v1/verifications` مع رقم الشهادة ومعرّف المستفيد. تُعيد الاستجابة تقريراً موثّقاً يحتوي على الجهة المصدرة وسنة التخرّج وبصمة توثيق موقّعة.

٣. التعامل مع الحالات غير المتزامنة

تُنجَز معظم الطلبات خلال ثوانٍ. أما الحالات التي تتطلّب مراجعة يدوية فيمكن استطلاعها عبر `GET /v1/verifications/{id}` أو تسجيل Webhook وانتظار حدث `verification.completed`.

٤. الانتقال إلى الإنتاج

بعد اجتياز اختباراتك على البيئة التجريبية، اطلب بيانات الإنتاج. سيشرح لك مدير النجاح حدود الاستخدام والمراقبة وخطة الرجوع قبل أول طلب حقيقي.