الانتقال إلى المحتوى الرئيسي
PATCH
curl
لاتخاذ قرار بشأن التطابقات الفردية بدلاً من الفحص الكامل، استخدم تحديث حالة تطابق AML. أما كيفية إنتاج نتائج الفحص والحالات، فراجع فحص AML.

التفويضات

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 لجلسة التحقق (session_id الذي تم إرجاعه بواسطة POST /v3/session/). يقبل معرّفات جلسات التحقق من المستخدمين (KYC) والتحقق من الشركات (KYB): يطابق الخادم المعرّف عبر كلا نوعي الجلسات. يجب أن يكون UUID صالح البنية؛ تؤدي القيمة غير صالحة البنية إلى عدم مطابقة المسار وإرجاع 404 بتنسيق HTML.

مثال:

"11111111-2222-3333-4444-555555555555"

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

node_id
string

معرّف عقدة مخطط سير العمل لفحص AML المراد تحديثه. مطلوب فقط عند تشغيل الجلسة لأكثر من خطوة AML واحدة. له الأولوية على node_id في جسم الطلب.

مثال:

"feature_aml_1"

الجسم

application/json
status
enum<string>
مطلوب

الحالة الجديدة لفحص AML.

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

"Approved"

node_id
string

معرّف عقدة مخطط سير العمل لفحص AML، كبديل لمعامل الاستعلام.

مثال:

"feature_aml_1"

الاستجابة

تم تعيين حالة فحص AML (أو بقيت دون تغيير عندما كانت تحمل هذه القيمة بالفعل).

message
string
مطلوب

دائماً AML status updated successfully.

status
enum<string>
مطلوب

حالة فحص AML الآن.

الخيارات المتاحة:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
previous_status
enum<string>
مطلوب

الحالة قبل الاستدعاء. تساوي status عندما لا يتغير شيء.

الخيارات المتاحة:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
آخر تعديل في ٧ نوفمبر ٢٠٢٦