الانتقال إلى المحتوى الرئيسي
POST
Python
أرسل نفس محتوى الطلب الذي تنوي استخدامه مع فحص الاحتيال. لا ينشئ التخطيط أي فحص أو جلسة، ولا يستدعي أي مزود إثراء، ولا يقرأ أي سجل شبكة، ولا يتم تحصيل أي رسوم. تفصل كل وحدة بين available وwill_run. يوضح availability_reason ما إذا كانت المدخلات المقدمة تتيح تشغيلها، بينما يوضح selection_reason سبب اختيارها أو عدم اختيارها. أبقِ المفاتيح غير المتاحة ظاهرة واعرض متطلبات المدخلات الخاصة بها. يتطلب networks_cross_org خطة Enterprise وضبط وضع المشاركة في مؤسستك على global. من دونهما، أو عندما لا تكون Networks مفعّلة لمؤسستك، يبلغ التخطيط عن ذلك بـ available: false وavailability_reason: "entitlement_required". يتخطاها أي فحص يحددها بالسبب نفسه. لا تخضع تطبيقات البيئة التجريبية لقيود الخطة أو وضع المشاركة: عند وجود معرّف مدعوم، تعمل الوحدة وتعيد نتيجة عينة فارغة. estimated_price سلسلة عشرية مقوّمة بالعملة المحددة في currency. السعر null يعني غير متاح أو غير مسعّر، وليس مجانياً. يجمع التقدير على المستوى الأعلى الوحدات القابلة للتشغيل المحددة، ويتحقق can_afford أيضاً من ترتيب الفوترة المعمول به. أعد التخطيط بعد تغيير المعرّفات أو السياق أو التحديدات. يعيد التنفيذ التحقق من الأهلية والتسعير، لذا فالتخطيط ليس حجزاً، ولا يضمن أن يستجيب المصدر الخارجي.

التفويضات

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

الاستجابة

profile_id
string
مطلوب
profile_version
string
مطلوب
modules
object[]
مطلوب
estimated_price
string | null
مطلوب
currency
string | null
مطلوب
is_sandbox
boolean
مطلوب
can_afford
boolean
مطلوب
آخر تعديل في ٧ نوفمبر ٢٠٢٦