يقتصر استيراد هذه البيانات وتصديرها هنا على إنشاء ملفات تعريف User أو تحديثها فقط. لا يعيد إنشاء جلسات KYC السابقة، أو تحذيرات المستندات، أو أدلة اكتشاف الحيوية، أو قرارات المزوّد. للترحيل الكامل من Sumsub أو MetaMap أو Veriff أو Onfido أو Persona أو أي مزوّد آخر، راجع استيراد البيانات من مزوّد آخر.
استيراد المستخدمين من ملف CSV
متى تستخدمه
- ترحيل في يوم الإطلاق من مزوّد KYC آخر: انقل قائمة المستخدمين الحالية إلى Didit.
- ترحيل صور الوجه من المزوّد: أرفق صور الوجه الموثوقة بملفات تعريف User المستوردة بعد إنشاء الصفوف.
- تسجيل جماعي لقائمة عملاء شريك.
- تعبئة البيانات الوصفية لاحقًا: حدّث الوسوم أو المستوى أو المعرّفات الداخلية لعدد كبير من المستخدمين دفعة واحدة.
أعمدة القالب
نزّل القالب من Users → Import → Download template. الأعمدة:تشغيل الاستيراد
1
ارفع ملف CSV
انتقل إلى Users → Import → Upload CSV واختر ملفك.
2
راجع المعاينة
تتحقق وحدة التحكم من كل صف. تُبرز الصفوف غير الصالحة مع أسباب الخطأ (مثل تكرار
vendor_data أو رمز دولة غير صالح).3
ابدأ الاستيراد
يعالج Didit الصفوف بشكل غير متزامن. يمكنك إغلاق علامة التبويب، ويُتابَع التقدم في Users → Import history.
4
راجع النتائج
عند انتهاء الاستيراد، يعرض سجل الاستيراد عدد الصفوف التي أُنشئت وحُدّثت وتم تخطيها، مع تقرير أخطاء قابل للتنزيل.
التحديث مقابل الإنشاء
- إذا لم يكن
vendor_dataموجودًا، يُنشأ User جديد. - إذا كان
vendor_dataموجودًا، يحدّث المستخدم الحالي (حقول الملف الشخصي والبيانات الوصفية). - لا تُستبدل أبدًا العدادات الإجمالية والحقول المتحقَّق منها (
full_nameوdate_of_birthمن الجلسات المقبولة) عند الاستيراد.
استيراد الوجوه بعد إنشاء المستخدم
ينشئ استيراد CSV صف User أو يحدّثه. ولا يتضمن صور الوجه في ملف CSV. لنقل البيانات البيومترية للوجه من مزوّد آخر، ارفع كل وجه بعد وجود User المستهدف:1
أنشئ User أو استورده
استخدم استيراد CSV في وحدة التحكم، أو استدعِ
POST /v3/users/create/ في حلقة تكرار.2
اقرأ didit_internal_id
استرجع User باستخدام
GET /v3/users/{vendor_data}/. تتضمن الاستجابة didit_internal_id.3
ارفع الوجه
استدعِ
POST /v3/organization/{organization_id}/application/{application_id}/vendor-users/by-id/{didit_internal_id}/faces/upload/ مع صورة وجه بترميز base64 خام.تصدير المستخدمين إلى ملف CSV
متى تستخدمه
- تدقيقات الامتثال: سلّم جدول المستخدمين الكامل إلى المدققين.
- مزامنة مستودع البيانات: تفريغ دوري إلى أدوات ذكاء الأعمال لديك.
- طلبات SAR أو طلبات الجهات التنظيمية: استخرج مجموعات فرعية مصفّاة من المستخدمين.
تشغيل التصدير
- انتقل إلى Users → Export.
- طبّق المرشحات (الحالة، الدولة، النطاق الزمني، البحث).
- اختر الأعمدة (الافتراضي هو كل الحقول، ويمكنك حذف ما لا تحتاجه).
- أرسل الطلب. يُنشئ Didit التصدير بشكل غير متزامن ويرسل رابط تنزيل موقّع بالبريد الإلكتروني إلى المشغّل الذي طلبه.
لا يتضمن التصدير إلا البيانات التي يُسمح لدورك بقراءتها. يمكن لـ COMPLIANCE_OFFICER وما فوقه تصدير الجدول الكامل، بينما تخضع أدوار DEVELOPER وREADER لقيود على التصدير.
خصائص الأداء
سجل التدقيق
يُسجَّل كل استيراد وتصدير في سجل التدقيق:- المشغّل الذي بدأ العملية.
- عدد الصفوف (للاستيراد) / لقطة المرشحات (للتصدير).
- الطوابع الزمنية وحالة النجاح أو الفشل.
الخطوات التالية
واجهة API إنشاء المستخدم
الإنشاء البرمجي لعمليات الاستيراد التي تنفّذها البرامج النصية.
رفع وجه المستخدم
أرفق صور الوجه المستوردة بملفات تعريف المستخدمين.
الاحتفاظ بالبيانات
المدة التي تبقى فيها البيانات المستوردة محفوظة.
سجلات التدقيق
راجع سجل الاستيراد والتصدير.