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

نظرة عامة

يفعّل أو يعطّل مراقبة AML المستمرة للـكيانات الشركات المحددة، تماماً كما يفعل إجراء مراقبة AML المستمرة في Business Console. وتشغّل Business Console ونقطة النهاية هذه العملية الأساسية نفسها، لذا فالقواعد والفوترة والنتائج متطابقة. أرسل estimate_only: true أولاً لمعرفة عدد الشركات المحددة، وعدد الشركات التي تحتاج إلى فحص AML جديد، وتكلفة الفحص لمرة واحدة، وتكلفة المراقبة السنوية. لا يُكتب أي شيء في وضع التشغيل التجريبي. يستخدم التقدير أسماء الحقول نفسها المستخدمة في endpoint المستخدمين، لذا فإن users_total هو عدد الشركات المحددة.

كيفية معالجة الاختيار

  • فحص واحد خاضع للمراقبة لكل شركة. تُراقَب الشركة التي خضعت للتحقق عدة مرات وتُفوَّتر مرة واحدة. يؤدي التعطيل إلى إيقاف المراقبة عبر جميع فحوص الشركة.
  • تُفحص الشركات التي لا تملك فحص AML أولاً. تنشئ Didit فحص AML جديداً لها (يظهر في تبويب التحققات الخاص بالشركة)، وتُفوَّتر تكلفته كتكلفة فحص AML عادي، ثم تُفعَّل المراقبة عليه. يستخدم الفحص الاسم القانوني للشركة (أو اسم العرض) وبلدها. والشركة التي لا تملك أي اسم تُبلَّغ بالحالة skipped_no_identity_data بدلاً من أن تُستبعد بصمت.
  • لا تنشئ تطبيقات البيئة التجريبية فحوصات أبداً (skipped_sandbox).
  • يُفحص الرصيد مسبقاً. يُرفض التفعيل برمز 403 عندما لا يغطي رصيدك التقدير، وتتضمن الاستجابة التقدير حتى تعرف مقدار ما تحتاج إلى شحنه.
  • التجديد السنوي. تُحتسب على الشركة المُراقَبة حديثاً قيمة المراقبة السنوية عند تاريخ تجديدها التالي، وهو التاريخ نفسه الذي تعرضه Console في عمود المراقبة المستمرة. يوقف التعطيل التجديد، ولا يسترد فترةً سبق احتسابها.

الاختيار وحجم الدفعة

اختر الشركات باستخدام vendor_data_list أو didit_internal_id_list أو كليهما؛ والقائمتان تُجمعان بمنطق OR. يقبل الطلب 1000 معرّف كحد أقصى عبر القائمتين معاً. تُعاد المعرّفات التي لا تطابق أي شركة في تطبيقك ضمن unmatched كما أُرسلت تماماً، ولا تُفشل الطلبَ أبداً: الاختيار الذي لا يطابق شيئاً يكتمل كمهمة فارغة (total: 0) مع إدراج كل المعرّفات، وذلك وفق الأسلوب نفسه المتبع في endpoints الحذف الدفعي.

التنفيذ المباشر أو في الخلفية

تُعالَج الاختيارات التي تضم 20 شركة أو أقل مباشرة، ويعيد الاستدعاء 200 مع المهمة المكتملة. أما الاختيارات الأكبر فتعيد 202 مع مهمة بحالة PENDING؛ استعلم عن الحصول على مهمة مراقبة AML حتى تصبح status بالقيمة COMPLETED أو FAILED. وفي الحالتين تحمل المهمة إدخالاً واحداً في results لكل شركة مع outcome الخاص به.

webhook

لا يُصدر تبديل المراقبة أي webhook خاص به. وبمجرد تفعيل المراقبة، تستمر عمليات إعادة الفحص في إطلاق الأحداث المعتادة status.updated وdata.updated الموضحة في مراقبة AML المستمرة.

الأذونات

يمكن لأي مفتاح API نشط للتطبيق استدعاء نقطة النهاية هذه. مفاتيح Didit API مرتبطة بالتطبيق وليست بالأدوار. أما الأدوار والأذونات في Console فتحدد ما يمكن للشخص فعله داخل Console، ولا تُطبَّق على حركة Management API.

ذات صلة

التفويضات

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.

الجسم

application/json

حدد الشركات باستخدام vendor_data_list أو didit_internal_id_list أو كليهما (يتم الجمع بين القائمتين باستخدام المعامل OR). بحد أقصى 1000 معرّف لكل طلب عبر كلتا القائمتين.

is_enabled
boolean
مطلوب

true لتفعيل المراقبة، وfalse لتعطيلها.

estimate_only
boolean
افتراضي:false

عند التعيين على true، يُرجع تقدير التكلفة ولا ينفذ أي عمليات كتابة - لا فحص، ولا فوترة، ولا مهمة.

vendor_data_list
string[]

المعرّفات الخاصة بك للشركات المراد تبديل حالتها، وتتم مطابقتها تماماً كما أُرسلت.

didit_internal_id_list
string<uuid>[]

المعرّفات الداخلية لـ Didit للشركات المراد تبديل حالتها - وهي معرّفات didit_internal_id التي تُرجعها endpoints الخاصة بالإنشاء والجلب والقائمة.

الاستجابة

التقدير (عندما يكون estimate_only صحيحاً) أو المهمة المكتملة لاختيار تمت معالجته بشكل مضمّن.

معاينة التكلفة. يتم إرجاعها مباشرة عندما يكون estimate_only صحيحاً (لا يتم كتابة أي شيء).

users_total
integer
مطلوب

الملفات الشخصية المطابقة للتحديد.

already_enabled
integer
مطلوب

الملفات الشخصية الخاضعة للمراقبة بالفعل (لا يلزم اتخاذ أي إجراء عند التفعيل؛ هذه هي الملفات التي يتم إيقافها عند التعطيل).

with_existing_aml
integer
مطلوب

الملفات الشخصية التي سيتم تحويل فحص AML الحالي الخاص بها إلى قيد المراقبة (دون إجراء فحص جديد).

needing_screening
integer
مطلوب

الملفات الشخصية التي لا تخضع لأي فحص AML وسيُجرى فحصها أولاً (تتم فوترتها كفحص AML عادي).

skipped_no_identity_data
integer
مطلوب

الملفات الشخصية التي لا يمكن فحصها بسبب نقص بيانات الهوية.

skipped_blocked
integer
مطلوب

المستخدمون المحظورون الذين سيتم تخطيهم (تكون دائماً 0 للشركات).

estimated_screening_cost_usd
number
مطلوب

التكلفة لمرة واحدة لعمليات الفحص الجديدة.

مثال:

0.2

estimated_annual_monitoring_cost_usd
number
مطلوب

تكلفة المراقبة السنوية للملفات الشخصية التي ستصبح خاضعة للمراقبة.

مثال:

0.07

balance_sufficient
boolean
مطلوب

ما إذا كان رصيد المؤسسة يغطي الفحص بالإضافة إلى السنة الأولى من المراقبة.

unmatched
string[]
مطلوب

معرّفات الطلب التي لم تطابق أي ملف تعريف في هذا التطبيق، تماماً كما أُرسلت.

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