الانتقال إلى المحتوى الرئيسي
POST
Python
أرسل المعرّفات المكتوبة وسمات الهوية المُدّعاة، واختر الفحوص التي تريد تشغيلها، وافحص نتيجة كل فحص على حدة. استخدم تخطيط فحص الاحتيال أولاً للتحقق من متطلبات الإدخال والرسوم المقدّرة.

اختيار الملف الشخصي

ثبّت profile_version حتى تكون القيم الافتراضية المختارة وسياسة القرار واضحةً صراحةً. الملف الشخصي الافتراضي هو standard، بالإصدار 2026-08-27. يضيف الإصدار 2026-09-14 الإثراء الاجتماعي الاختياري للبريد الإلكتروني ورقم الهاتف، ويسجّل كل فحص مكتمل كجلسة أصلية للتحقق من المستخدمين. وفي هذا الإصدار، الإضافات المدفوعة اختيارية ولا تُفعَّل إلا صراحةً. ويفعّل الإصدار 2026-09-14.1 أيضاً عمليات البحث عن معرّفات الشبكة العالمية لمكافحة الاحتيال للمؤسسات على خطة Enterprise التي تشارك بياناتها عالمياً. ويضيف الإصدار 2026-09-14.2 فحصاً اختيارياً لمطابقة صورة السيلفي مع رقم CPF في البرازيل. وتحتفظ الإصدارات السابقة بسلوكها الأصلي. تدعم الملفات الشخصية الحالية تقييم مخاطر البريد الإلكتروني ورقم الهاتف وعنوان IP، والتحقق من قواعد البيانات حيثما كان مؤهلاً، وسجلّ الشبكة الخاصة بتطبيقك. يتطلب ربط الهوية القائم على السيلفي الإصدار 2026-09-14.2. ويؤدي اختيارها في الإصدارات السابقة إلى إرجاع not_available_in_profile_version.

الهوية المُدّعاة والسياق

ضع البريد الإلكتروني ورقم الهاتف والمعرّفات الحكومية في subject.identifiers. تتطلب المعرّفات الحكومية تحديد دولة الإصدار، وقد يلزم تحديد الجهة المُصدِرة أيضاً في الحالات التي تكون فيها الأرقام فريدةً ضمن منطقة معيّنة فقط. ضع الأسماء وتاريخ الميلاد والجنسية والعنوان في subject.attributes. هذه ادعاءات تُقارَن عندما يدعمها المصدر المختار، وليست حقائق موثّقة لمجرد أنها قُدّمت. استخدم context لعنوان IP الخاص بالمحاولة ووكيل المستخدم والغرض والدولة وأي إقرار موافقة مطلوب. يفصل ذلك بين المعلومات المتعلقة بمحاولة التحقق والمعلومات المتعلقة بالشخص. بالنسبة إلى الفحوص البيومترية المدعومة، أرسل subject.selfie كصورة JPEG أو PNG أو WebP مرمّزةً بصيغة base64، بحجم أقصاه 6 ميغابايت. كما يُقبل رابط البيانات (data URI) للصورة نفسها. لا ترسل صورة مرجعية أو رابط URL بعيداً أو مفتاح تخزين.

السيلفي والمعرّف المُدّعى

اختر biometric_identity، وأرسل معرّف tax_number برازيلياً وصورة السيلفي، وتأكد من context.consent_obtained. يتحقق المرجع من أن صورة السيلفي تعود إلى صاحب رقم CPF المُدّعى. يُرجع غياب الموافقة consent_required، ويُرجع البلد غير المدعوم unsupported_region. للوحدة سعر لكل فحص، ويعتمد هذا السعر على معدل التحقق من قواعد البيانات الخاص بمؤسستك، فراجع الخطة قبل التشغيل. عندما يقدّم المرجع إجابته، تكون قيمة identity_relationship.result إما match أو mismatch أو inconclusive. تتطلب الإجابة غير الحاسمة مراجعةً، ولا تُعامَل أبداً كعدم تطابق. لا تُثبت النتيجة إلا العلاقة بين صورة السيلفي ورقم CPF. ولا تتحقق من اسم أو تاريخ ميلاد مُقدَّم، ولا تثبت الحيوية، ولا تبحث عن الوجه عبر الإنترنت أو الشبكة العالمية لمكافحة الاحتيال. تبقى الأسماء وتاريخ الميلاد ادعاءات ما لم يوفّر مصدر آخر مختار أدلةً على هذه الحقول. تُعدّ مهلات الانتظار وأخطاء المصدر نتائج غير متاحة، ولا تُفوتَر. تُفوتَر الإجابات غير الحاسمة المكتملة بالسعر نفسه لفحص المرجع. لا يُدرج هذا الفحص صورة السيلفي في النتيجة، ولا يخزّنها كوسائط للجلسة.

اختيار الفحوص

تحدد checks.include الوحدات، وتتقدّم checks.exclude عليها. تعطّل قائمة include الفارغة المحددة صراحةً جميع الأعمال الاختيارية، ومع ذلك تستمر عملية التطبيع. عند حذف include تُستخدم القيم الافتراضية للملف الشخصي المثبّت. يُختار الإثراء الاجتماعي للبريد الإلكتروني ورقم الهاتف بشكل منفصل باستخدام email_social وphone_social. وهما يتطلبان معرّفاً صالحاً ومطابقاً، ولا يرسلان رمز OTP.

قراءة النتائج دون الخلط بينها

تُبلغ كل وحدة عن حالة تنفيذها وسببها ووحداتها القابلة للفوترة. تصف not_requested وexcluded_by_caller وmissing_required_input وsource_unavailable نتائج مختلفة. المصدر المفقود ليس عدم تطابق في الهوية، ولا نتيجة بمخاطر صفرية. يصف attribute_evidence الأدلة على مستوى الحقول، بينما يُبقي risk أبعاد الهوية والتواصل والجهاز والسلوك والشبكة الاحتيالية منفصلةً. البريد الإلكتروني أو الجهاز أو المعرّف الآخر المشترك هو صلة مرصودة، وليس دليلاً على أن حسابين يعودان إلى الشخص نفسه أو على أن احتيالاً قد ارتُكب. recommendation هي توصية الفحص نفسه، ولا تغيّر حالة سجل آخر. تظهر نتائج الإثراء الاجتماعي ضمن enrichment، مع تمييز النتائج غير المتاحة عن النتائج المكتملة.

الشبكة العالمية لمكافحة الاحتيال

اختر networks_cross_org للاستعلام عن معرّفات البريد الإلكتروني والهاتف المدعومة، ومعرّفات المستندات المحددة بمساحة أسماء صحيحة، في الشبكة المشتركة. يتطلب الاستعلام خطة Enterprise وضبط وضع المشاركة في مؤسستك على global. بدونهما، تُبلغ الخطة عن الوحدة بقيمة available: false وavailability_reason: "entitlement_required"، ويتخطاها الفحص الذي يختارها مع الحالة skipped والسبب entitlement_required. ينطبق السبب نفسه عندما لا تكون الشبكات مفعّلة لمؤسستك. لا تخضع تطبيقات البيئة التجريبية للخطة ولا لوضع المشاركة: مع معرّف مدعوم، تُشغَّل الوحدة وتعيد نتيجة عينة فارغة. يستهلك الاستعلام ميزانية القراءة الحالية لمؤسستك ويسجّل تدقيقًا لعملية القراءة. لا تُفرض عليه رسوم لكل استعلام. تخطيط الفحص لا يستعلم عن الفهرس المشترك ولا يستهلك ميزانية القراءة الخاصة به. يتضمن network.cross_organization الحقل signals_checked والحقل insights المجمّعة المُفصَح عنها عند اكتمال الفحص. تتضمن كل رؤية نوع الإشارة وفئات النتائج وعدد المساهمين وفئة الحداثة، كما تتضمن فئات الصناعة فقط عند تفعيل الإفصاح. لا تحدد هذه البيانات أبدًا أي مؤسسة أخرى أو حسابًا أو شخصًا أو عملية تحقق. تُستبعد النتائج الواقعة دون حد الإفصاح، وقائمة فارغة لا تثبت غياب سجل الاحتيال. تُطلق الإشارة المشتركة المُفصَح عنها توصية بالمراجعة، ولا تُفضي أبداً إلى رفض تلقائي أو تطابق للهوية. يُبلغ الاستعلام غير المتاح عن سببه بشكل منفصل عن استعلام مكتمل وفارغ. إذا فقدت مؤسستك لاحقاً الوصول عبر المؤسسات، مثلاً بعد تغيير الخطة أو عندما لم يعد وضع المشاركة global، فإن استرجاع النتائج وإعادة المحاولات وتفاصيل الجلسات تُخفي التجميعات المشتركة وأدلة المخاطر المشتقة منها. تبقى التوصية الأصلية قراراً تاريخياً، ولا تغيّر عمليات القراءة حالة التحقق.

الجلسات وإعادة المحاولات والرسوم

يسترجع check_id النتيجة المخزّنة عبر الحصول على فحص احتيال. عند وجوده، يحدد request_id جلسة التحقق الأصلية الخاصة به. تُنشئ الإصدارات 2026-09-14 و2026-09-14.1 و2026-09-14.2 تلك الجلسة دائماً، بما في ذلك عندما يُختار سجل الشبكة الخاصة وحده. إعادة استخدام client_reference مع محتوى الطلب نفسه تُعيد النتيجة الأصلية دون تنفيذ آخر أو رسوم أخرى ما دام ذلك الفحص موجوداً. محتوى طلب مختلف مع المرجع نفسه يُعيد 409. إذا كان التنفيذ ما زال جارياً، أعد إرسال الطلب نفسه بعد الفاصل الزمني المحدد في الرأس Retry-After للاستجابة. حذف عملية التحقق المرتبطة يحذف نتيجة فحص الاحتيال أيضاً، ويُعيد الاسترجاع بعد ذلك 404. لا يمكن لفحص حُذف أثناء التنفيذ أن ينشر نتيجة مكتملة. تُحتسب الأسعار من أسعار مؤسستك الحالية المدفوعة مسبقاً أو المتعاقد عليها. لا تُفرض رسوم على الوحدات غير المتاحة أو المتخطاة، ولا يُفرض على سجل الشبكة الخاصة رسم لكل فحص. تستخدم فحوصات البيئة التجريبية استجابات عينة دون استدعاءات مدفوعة لمزوّدي الخدمة أو رسوم.

التفويضات

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.

الجسم

subject
object
مطلوب
client_reference
string

المرجع الخاص بك لعملية الفحص هذه. يعمل أيضاً كمفتاح idempotency: إعادة استخدامه مع نفس الطلب يعيد الفحص الأصلي دون تشغيل الوحدات أو فوترتها مرة أخرى؛ وإعادة استخدامه مع طلب مختلف يعيد 409.

Required string length: 1 - 255
profile
string
افتراضي:standard

معرّف ملف التنسيق. يتم تعيينه افتراضياً على ملف Didit standard.

Required string length: 1 - 64
profile_version
string

تثبيت نسخة مجمدة من الملف التعريفي. القيمة الافتراضية هي النسخة الحالية للملف التعريفي.

Required string length: 1 - 32
context
object
checks
object
vendor_data
string
Maximum string length: 1000
metadata
any

الاستجابة

check_id
string<uuid>
مطلوب
client_reference
string | null
مطلوب
processing_status
enum<string>
مطلوب
  • pending - معلق
  • running - قيد التشغيل
  • completed - مكتمل
  • failed - فشل
الخيارات المتاحة:
pending,
running,
completed,
failed
profile_id
string
مطلوب
profile_version
string
مطلوب
created_at
string<date-time>
مطلوب
completed_at
string<date-time> | null
مطلوب
inputs
object[]
مطلوب
modules
object[]
مطلوب
attribute_evidence
object[]
مطلوب
compound_evidence
object[]
مطلوب
risk
object[]
مطلوب
network
object
مطلوب
recommendation
enum<string>
مطلوب
  • approve - موافقة
  • review - مراجعة
  • reject - رفض
الخيارات المتاحة:
approve,
review,
reject
next_action
enum<string>
مطلوب
  • none - لا شيء
  • manual_review - مراجعة يدوية
  • step_up - تصعيد
  • resubmit_capture - إعادة إرسال الالتقاط
الخيارات المتاحة:
none,
manual_review,
step_up,
resubmit_capture
decision_reasons
string[]
مطلوب
coverage
object
مطلوب
usage
object[]
مطلوب
request_id
string<uuid>

جلسة تحقق أصلية تم إنشاؤها لهذا الفحص.

enrichment
object
identity_relationship
object | null
vendor_data
string | null
metadata
unknown
آخر تعديل في ٧ نوفمبر ٢٠٢٦