الانتقال إلى المحتوى الرئيسي
GET
curl
يسجّل كل استدعاء لـتحديث حالة الميزة تجاوزًا لحالة فحص واحد. يسرد هذا endpoint كل التجاوزات الخاصة بجلسة واحدة، من الأحدث إلى الأقدم، دون تقسيم إلى صفحات.

حالات التجاوز

طُبّق التجاوز الذي يحمل forced: true فورًا، والشخص ما زال في التدفق.

سبب إلغاء تجاوز في الانتظار

أين يقع الشخص في التدفق

تكون person_in_flow بقيمة true طالما كانت الجلسة في حالة Not Started أو In Progress أو Resubmitted ولم ينهِ الشخص التدفق. وطالما كانت القيمة true، ينتظر أي تجاوز جديد يحمل defer_until_flow_finishes: true. يحدد flow_finished_at وقت آخر مرة أنهى فيها الشخص التدفق. تكون القيمة null طالما ما زال الشخص في التدفق، بما في ذلك إعادة التقديم، وعندما تُغلق الجلسة قبل أن ينهيه الشخص.

ذات صلة

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

sessionId
string<uuid>
مطلوب

معرّف UUID لجلسة التحقق. يقبل معرّفات جلسات المستخدمين (KYC) والشركات (KYB).

مثال:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

الاستجابة

تجاوزات الفحص الخاصة بالجلسة، الأحدث أولاً.

session_id
string<uuid>
مطلوب
مثال:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

person_in_flow
boolean
مطلوب

ما إذا كان الشخص لا يزال في المسار، بحيث ينتظر التجاوز الجديد مع defer_until_flow_finishes: true.

مثال:

true

flow_finished_at
string<date-time> | null
مطلوب

متى أنهى الشخص التدفق آخر مرة. وتكون null طالما أنه لا يزال بداخله (بما في ذلك إعادة التقديم) وعندما أُغلقت الجلسة قبل أن يُنهيه (متروكة أو منتهية الصلاحية أو تم اتخاذ قرار في منتصف التدفق).

مثال:

null

overrides
object[]
مطلوب

كل تجاوز للجلسة، الأحدث أولاً.

آخر تعديل في ٧ نوفمبر ٢٠٢٦