الانتقال إلى المحتوى الرئيسي
PATCH
curl

ما الذي يفعله هذا

يُرجع فحص AML قائمة بـنتائج التطابق، وهي تطابقات محتملة مع قوائم العقوبات وقواعد بيانات الأشخاص المعرّضين سياسياً وقوائم المراقبة والأخبار السلبية. لكل نتيجة review_status (حالتها) تبدأ بالقيمة Unreviewed أو False Positive بحسب درجة التطابق. تتيح لك نقطة النهاية هذه (أو أتمتتك) تسجيل قرار لكل نتيجة، دون تغيير قرار الجلسة الإجمالي. ابحث عن النتائج ومعرّفاتها في قرار الجلسة، أي مصفوفة hits في فحص AML، حيث يكون id لكل نتيجة هو hit_id الذي تمرره هنا. يبدأ معرّف النتيجة id بـ hit_ يليه 24 محرفاً سداسي عشرياً، ويبقى ثابتاً عند إعادة فحص الشخص. ما زال المعرّف المُعاد بالصيغة السابقة مقبولاً، لكن الاستجابة تذكر النتيجة دائماً بمعرّفها id الحالي.

حالات المراجعة

تُحفظ قرارات المراجِع عبر إعادات الفحص في المراقبة المستمرة، فالنتيجة التي تضع عليها False Positive تحتفظ بهذه الحالة عندما يعيد المزوّد فحص الكيان.

تحديث نتيجة واحدة

PATCH /v3/session/{sessionId}/update-aml-hit-status/
بالنسبة إلى جلسة تحتوي على فحوصات AML متعددة (سير عمل قائمة على المخططات)، أضف ?node_id=feature_aml_1 إلى عنوان URL، أو أدرج "node_id" في الجسم لاستهداف فحص محدد.

تحديث نتائج كثيرة دفعة واحدة

PATCH /v3/session/{sessionId}/bulk-update-aml-hit-status/ مرّر hit_updates، وهي قائمة من أزواج { hit_id, review_status }. العملية كل شيء أو لا شيء: إذا كان أيٌّ من قيم hit_id غير موجود، يُرجع الطلب الرمز 404 ولا تتغير أي نتيجة.
يُطلق الاستدعاء الجماعي الناجح حدث webhook واحداً هو data.updated، ويسجّل إدخال نشاط واحداً يشمل كل التغييرات.

ما الذي يحدث بعد التحديث

  • Webhook: يُطلق حدث data.updated على الجلسة.
  • سجل التدقيق: يُسجَّل التغيير في مسار مراجعة الجلسة مع الجهة المنفذة (مفتاح API أو المستخدم)، ويظهر في الخط الزمني للنشاط في الكونسول.
  • حالة خطوة AML الإجمالية لا تتأثر: تغيير حالة نتيجة لا يغيّر بحد ذاته حالة خطوة AML أو قرار الجلسة. لتغيير حالة الخطوة في AML (Approved / Declined / In Review)، استخدم تحديث حالة الميزة. ولتغيير قرار الجلسة، استخدم تحديث الحالة.

دعم KYC وKYB

يعمل هذا مع جلسات التحقق من المستخدم (KYC) والتحقق من الشركات (KYB) على حد سواء، إذ يحدد Didit sessionId في النوعين. في حالة KYB، يُجرى فحص AML على الشركة وعلى أشخاصها الرئيسيين، ويعرض كل فحص AML نتائجه الخاصة.

الإذن

يتطلب الصلاحية write:sessions، مع مفتاح API للعميل (x-api-key) أو رأس تفويض المستخدم.

الأخطاء

ذات صلة

التفويضات

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) — يطابق الخادم المعرّف عبر كلا نوعي الجلسات.

مثال:

"11111111-2222-3333-4444-555555555555"

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

node_id
string

معرّف عقدة مخطط سير العمل. مطلوب فقط عندما تحتوي الجلسة على فحوصات AML متعددة (واحد لكل عقدة)؛ احذفه للجلسات ذات فحص AML الفردي.

مثال:

"feature_aml_1"

الجسم

application/json
hit_id
string
مطلوب

معرّف id الخاص بالمطابقة في مصفوفة hits لفحص AML‏ (hit_...). لا يزال معرّف المطابقة المُرجع بالصيغة السابقة مقبولاً.

مثال:

"hit_7c1e9a40b2d35f86e0a4c912"

review_status
enum<string>
مطلوب

حالة المراجعة الجديدة لنتيجة التطابق.

الخيارات المتاحة:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
مثال:

"False Positive"

node_id
string

معرّف اختياري لعقدة المخطط. استخدمه (هنا أو كمعامل استعلام) عندما تتضمن الجلسة عمليات فحص AML متعددة.

مثال:

"feature_aml_1"

الاستجابة

تم تحديث حالة مراجعة التطابق.

message
string
مطلوب

دائماً Hit status updated successfully.

hit_id
string
مطلوب

معرّف id الخاص بالمطابقة المحدّثة، كما يرجعه قرار الجلسة، وكذلك عندما يحدد الطلب المطابقة بمعرّف بالصيغة السابقة.

review_status
enum<string>
مطلوب

حالة المراجعة المخزنة حالياً في النتيجة المطابقة.

الخيارات المتاحة:
Unreviewed,
Confirmed Match,
False Positive,
Inconclusive
آخر تعديل في ٧ نوفمبر ٢٠٢٦