الانتقال إلى المحتوى الرئيسي
POST
curl
عند تجاوز خطوة باستخدام defer_until_flow_finishes: true بينما المستخدم لا يزال في سير العمل، ينتظر التجاوز ويُطبَّق عند انتهاء سير العمل. ألغِه من هنا إذا لم تعد تريد تطبيقه. يحتفظ الفحص بحالته الحالية. يُسجَّل الإلغاء في نشاط الجلسة باسم FEATURE_OVERRIDE_CANCELLED، ولا يُرسَل أي webhook. تكون الاستجابة هي التجاوز بالقيمتين state: cancelled وcancel_reason: cancelled_by_reviewer.

العثور على معرّف التجاوز

استخدم قيمة id من كائن override الذي تعيده تحديث حالة الميزة، أو اعرض تجاوزات الجلسة باستخدام عرض تجاوزات الميزات واختر تجاوزاً تكون قيمة state فيه pending_until_flow_finishes.

عند فشل الإلغاء

يُرجع تجاوزٌ سبق تطبيقه أو إلغاؤه الاستجابة 409 مع الرمز feature_override_not_pending. لتغيير فحص بعد تطبيق تجاوزه، أرسل بدلاً من ذلك طلب تحديث حالة الميزة جديداً.

ذات صلة

التفويضات

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"

overrideId
string<uuid>
مطلوب

معرّف id الخاص بالتجاوز المراد إلغاؤه.

مثال:

"9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3"

الاستجابة

تم إلغاء التجاوز ولن يتم تطبيقه أبداً.

تجاوز واحد لحالة فحص (ميزة) تم إجراؤه باستخدام PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/: ما يغيّره، وما إذا كان قد طُبّق أم لا يزال بانتظار إنهاء الشخص لسير العمل، ومن طلبه وسبب ذلك.

id
string<uuid>
مطلوب

معرّف التجاوز. مرّره إلى endpoint الإلغاء.

مثال:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

node_id
string
مطلوب

عقدة سير العمل المحددة في الطلب (default لخطوة بدون عقدة).

مثال:

"feature_ocr_1"

feature_type
string
مطلوب

قيمة feature_type التي مررها الطلب، أو سلسلة فارغة في حال لم يمرر أي قيمة.

مثال:

""

feature_model
string
مطلوب

نوع الفحص الذي تم تجاوزه، على سبيل المثال KYC أو Face أو AML أو GeolocationCheck.

مثال:

"KYC"

previous_status
enum<string>
مطلوب

حالة الفحص عند طلب التجاوز.

الخيارات المتاحة:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
مثال:

"In Review"

new_status
enum<string>
مطلوب

الحالة التي يحددها التجاوز.

الخيارات المتاحة:
Approved,
Declined,
In Review
مثال:

"Approved"

state
enum<string>
مطلوب

applied: أصبحت حالة الفحص الجديدة. pending_until_flow_finishes: ينتظر التجاوز ويُطبّق عندما ينهي الشخص سير العمل. cancelled: انتظر ولم يُطبّق أبدًا (راجع cancel_reason).

الخيارات المتاحة:
applied,
pending_until_flow_finishes,
cancelled
مثال:

"applied"

forced
boolean
مطلوب

تكون true عندما يتم تطبيق التجاوز فوراً بينما لا يزال الشخص في مسار التحقق.

مثال:

false

reason
string | null
مطلوب

قيمة comment المرسلة مع الطلب، أو null.

مثال:

"Document manually verified by compliance."

requested_by
object | null
مطلوب

من طلب التجاوز، أو null عندما لا يكون ذلك معروفاً.

requested_at
string<date-time>
مطلوب

متى تم طلب التجاوز.

مثال:

"2026-10-13T09:15:00Z"

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

وقت اتخاذ الفحص للحالة الجديدة، أو null أثناء انتظاره أو بعد إلغائه.

مثال:

"2026-10-13T09:15:00Z"

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

وقت إلغاء تجاوز الانتظار، أو null.

مثال:

null

cancel_reason
enum<string> | null
مطلوب

سبب عدم تطبيق التجاوز قيد الانتظار نهائياً، أو null. cancelled_by_reviewer: أُلغي بواسطة endpoint الإلغاء. replaced: حل محله تجاوز أحدث على الفحص نفسه. check_changed: أعاد الشخص إجراء الفحص قبل إنهاء سير العمل. session_closed: غادرت الجلسة سير العمل قبل أن يُنهيه الشخص (متروكة، أو منتهية الصلاحية، أو تم اتخاذ القرار أثناء سير العمل).

الخيارات المتاحة:
cancelled_by_reviewer,
replaced,
check_changed,
session_closed,
null
مثال:

null

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