الانتقال إلى المحتوى الرئيسي
تُعدّ الجلسات وحدة التحقق في Didit. عند بدء عملية تحقق، تُنشأ جلسة، وعند انتهاء التحقق تحمل الجلسة payload القرار الكامل. تتعامل واجهة برمجة الجلسات مع النوعين معًا: في درس الأكاديمية حول ما يراه المستخدمون، يقارن الفصل عند الدقيقة 5:34 بين التدفق المستضاف وبناء شاشاتك الخاصة، وهذه هي المفاضلة نفسها التي تحسمها عنك هذه الواجهة.

​
يحدد سير العمل نوع الجلسة

عند إنشاء جلسة، تمرر workflow_id. يحدد نوع سير العمل ما إذا كانت الجلسة من نوع التحقق من المستخدمين أو التحقق من الشركات، ولا يختار المتصل النوع بشكل منفصل. تنشئ سيرُ عمل KYB جلسات التحقق من الشركات، وتنشئ سيرُ عمل KYC جلسات التحقق من المستخدمين.

​
الحقل المُميِّز session_kind

تتضمن كل استجابة للجلسة، سواء من الإنشاء أو الاسترجاع أو السرد أو تحديث الحالة أو المشاركة أو الاستيراد، حقلًا على المستوى الأعلى:
  • "user": الجلسة جلسة التحقق من المستخدمين (KYC). تحتوي الاستجابة على مصفوفات الميزات الخاصة بالمستخدمين.
  • "business": الجلسة جلسة التحقق من الشركات (KYB). تحتوي الاستجابة على مصفوفات الميزات الخاصة بالشركات.
استخدم هذا الحقل لتحديد شكل البيانات في جهتك.
قيم التعداد هي المعرّفات القصيرة "user" و"business"، وقد أبقيناها قصيرة لتسهيل استخدام الواجهة. أما الأسماء الكاملة التحقق من المستخدمين (KYC) والتحقق من الشركات (KYB) فتُستخدم في الوثائق كلها للتوضيح.

​
مصفوفات الميزات حسب النوع

تعتمد مصفوفات الميزات الموجودة في القرار على النوع. الحقول الغائبة عن نوع ما لا تظهر في استجابته أصلًا (لا قيم null ولا عناصر نائبة):

​
الحقول المشتركة على المستوى الأعلى

تحمل كل جلسة (من النوعين) هذه الحقول:

​
endpoints المشمولة

تقبل endpoints التالية النوعين معًا. لا توجد مسارات منفصلة مثل /v3/business-session/*.

​
كيف يتم البحث

جلسات التحقق من المستخدمين وجلسات التحقق من الشركات نوعان مختلفان. تستخدم المعرّفات صيغة UUID فلا يمكن أن تتعارض. عند استدعاء endpoint بـsession_id، يقوم Didit بما يلي:
  1. يبحث عن المعرّف في جدول التحقق من المستخدمين أولًا، لأنه يتعامل مع معظم الطلبات.
  2. إذا لم يجده، يرجع إلى جدول التحقق من الشركات.
  3. يعيد الخطأ 404 إذا لم يوجد تطابق في الجدولين.
لا تحتاج أبدًا إلى إخبار الواجهة بالنوع الذي تبحث عنه.

​
الحالات متطابقة

قيم الحالة واحدة في النوعين، ويعيدها الـAPI كما هي مكتوبة هنا تمامًا: "Not Started" و"In Progress" و"Approved" و"Declined" و"In Review" و"Abandoned" و"Expired" و"Kyc Expired" و"Resubmitted" و"Awaiting User". المطابقة تامة وحساسة لحالة الأحرف. للاطلاع على المرجع الكامل، راجع حالات التحقق.

​
Webhooks

تتضمّن أحداث webhook بالفعل حقل session_kind حتى تتمكّن معالجات webhook لديك من التوجيه حسب كل نوع: راجع webhooks للتحقق من التوقيع ودلالات إعادة المحاولة، وwebhooks الخاصة بـ KYB للاطلاع على كتالوج أحداث التحقق من الشركات.

​
الخطوات التالية

إنشاء جلسة

ابدأ عملية تحقق، سواء التحقق من المستخدمين أو التحقق من الشركات.

استرجاع الجلسة

استرجع القرار. يعمل مع النوعين.

عرض الجلسات

صفِّ النتائج حسب session_kind.

تحديث الحالة

قبول، أو رفض، أو مراجعة، أو إعادة الإرسال.

إنشاء ملف PDF

تقارير PDF حسب النوع.

مشاركة + استيراد

انقل الجلسات بين التطبيقات.
آخر تعديل في ٧ نوفمبر ٢٠٢٦