نموذج بيانات المستخدم: مخطط مستخدم Didit

هذه الصفحة توثّق كل حقل في كيان User. تنقسم الحقول إلى خمس مجموعات: الهوية، والحالة، وإجماليات الجلسات، وطوابع النشاط الزمنية، والبيانات الوصفية.

حقول الهوية

الحقل	النوع	الوصف
`uuid`	UUID	المفتاح الأساسي الذي يعيّنه Didit. ثابت وفريد.
`didit_internal_id`	string	معرّف داخلي مقروء للإنسان (يظهر في استجابات API).
`vendor_data`	string	معرّفك الخاص للمستخدم. فريد لكل تطبيق. اقرأ المزيد.
`display_name`	string	اسم بديل يظهر في الكونسول. يُستخدم `full_name` أو `vendor_data` افتراضياً إذا لم يُضبط.
`full_name`	string	الاسم القانوني الكامل المأخوذ من مستند الهوية في آخر جلسة تحقق من المستخدمين (KYC) مقبولة.
`date_of_birth`	date (ISO 8601)	مأخوذ من آخر جلسة تحقق من المستخدمين (KYC) مقبولة.
`portrait_image`	URL	رابط S3 موقّع لصورة السيلفي من آخر كشف حيوية مقبول.

الحقول full_name وdate_of_birth وportrait_image للقراءة فقط عندما تُشتق من جلسة موثّقة. يمكنك تجاوزها عبر الكونسول أو عبر PATCH /v3/users/{vendor_data}/، لكن التجاوزات اليدوية تُسجَّل في سجل التدقيق.

الحالة

الحقل	النوع	القيم	الوصف
`status`	enum	`ACTIVE`, `FLAGGED`, `BLOCKED`	يتحكم في تطبيق القيود على الجلسات والمعاملات المستقبلية. انظر دورة الحياة.

إجماليات الجلسات

تحسب Didit هذه الحقول وتحدّثها في الوقت الفعلي كلما اكتملت جلسة.

الحقل	النوع	الوصف
`session_count`	int	إجمالي الجلسات التي أُنشئت لهذا المستخدم على الإطلاق
`approved_count`	int	الجلسات التي انتهت بحالة `APPROVED`
`declined_count`	int	الجلسات التي انتهت بحالة `DECLINED`
`in_review_count`	int	الجلسات الحالية بحالة `IN_REVIEW`
`issuing_states[]`	array of ISO country codes	الدول التي صدرت عنها جميع مستندات الهوية الموثّقة عبر الجلسات
`approved_emails[]`	array of strings	عناوين البريد الإلكتروني الموثّقة عبر التحقق من البريد الإلكتروني
`approved_phones[]`	array of strings	أرقام الهاتف الموثّقة عبر التحقق من رقم الهاتف
`features`	object	آخر حالة لكل ميزة عبر جميع الجلسات

خريطة `features`

تُشغّل كل جلسة ميزة واحدة أو أكثر (التحقق من الهوية، وكشف الحيوية، ومطابقة الوجه، وAML، وإثبات العنوان، وNFC، وغيرها). تحتفظ خريطة features بـآخر حالة لكل ميزة لهذا المستخدم:

{
  "id_verification": "APPROVED",
  "liveness": "APPROVED",
  "face_match": "APPROVED",
  "aml": "IN_REVIEW",
  "proof_of_address": "APPROVED",
  "nfc_verification": "NOT_FINISHED"
}

حالات الميزات: NOT_FINISHED, APPROVED, DECLINED, IN_REVIEW, EXPIRED, ABANDONED, RESUB_REQUESTED. استخدم خريطة features كمسار سريع للإجابة عن السؤال “هل هذا المستخدم موثّق بالكامل الآن؟” دون المرور على جميع الجلسات.

طوابع النشاط الزمنية

الحقل	النوع	يُحدَّث عند
`first_session_at`	ISO timestamp	إنشاء أول جلسة
`last_session_at`	ISO timestamp	إنشاء آخر جلسة أو تحديثها
`last_activity_at`	ISO timestamp	أي تغيير: جلسة، أو معاملة، أو حالة، أو ملف تعريف، أو ملاحظات، أو وسوم
`created_at`	ISO timestamp	إنشاء صف الكيان
`updated_at`	ISO timestamp	آخر تحديث لصف الكيان

البيانات الوصفية

الحقل	النوع	الوصف
`metadata`	object (JSON)	بيانات JSON حرة تتحكم بها أنت. استخدمها للوسوم الداخلية، والمستوى، ومصدر التسجيل، وغيرها.
`tags[]`	array	وسوم تُدار من الكونسول أو API للتصفية والتجميع

لا تحتوي البيانات الوصفية على أي مخطط محدد، إذ يحفظ Didit أي محتوى تكتبه.

العلاقات (غير مخزّنة في صف المستخدم)

العلاقة	طريقة الوصول
الجلسات	`GET /v3/sessions?vendor_data=<value>`
المعاملات (بصفته مقدّم الطلب)	`GET /v3/transactions/?vendor_data=<value>`
المعاملات (بصفته الطرف المقابل)	صفِّ قائمة المعاملات حسب vendor_data الخاص بالطرف المقابل في الكونسول
الشركات المرتبطة (مدير / مستفيد حقيقي)	تظهر في صفحة تفاصيل المستخدم في الكونسول
القياسات الحيوية للوجه	الكونسول وLists API
إدخالات قائمة الحظر	Lists API: صفِّ الإدخالات حسب معرّفات المستخدم

مثال على الاستجابة

{
  "uuid": "9c7d2a30-2f98-4d4f-9d2d-1a7c4b1e5b6a",
  "didit_internal_id": "U-2026-00042",
  "vendor_data": "user-42",
  "display_name": "Jane Doe",
  "full_name": "John Doe",
  "date_of_birth": "1990-01-01",
  "portrait_image": "https://<media-host>/...",
  "status": "ACTIVE",
  "session_count": 3,
  "approved_count": 2,
  "declined_count": 0,
  "in_review_count": 1,
  "issuing_states": ["US", "ES"],
  "approved_emails": ["jane@example.com"],
  "approved_phones": ["+14155550123"],
  "features": {
    "id_verification": "APPROVED",
    "liveness": "APPROVED",
    "face_match": "APPROVED",
    "aml": "IN_REVIEW"
  },
  "first_session_at": "2025-03-01T12:00:00Z",
  "last_session_at": "2026-04-10T09:00:00Z",
  "last_activity_at": "2026-04-16T10:00:00Z",
  "metadata": { "tier": "premium" }
}

الخطوات التالية

العمليات

الإنشاء والتحديث وتغيير الحالة والحذف.

سجل KYC

استرجاع كل جلسة مرتبطة بالمستخدم.

مرجع API

مخطط GET /v3/users//.

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

نظرة عامة

الأسعار

سير العمل والتحقق

المراجعة والعمليات

الكيانات (المستخدمون والشركات)

الإعدادات والتخصيص

الأمان والامتثال

Didit Academy

الموارد

نموذج بيانات المستخدم: مخطط مستخدم Didit

حقول الهوية

الحالة

إجماليات الجلسات

خريطة `features`

طوابع النشاط الزمنية

البيانات الوصفية

العلاقات (غير مخزّنة في صف المستخدم)

مثال على الاستجابة

الخطوات التالية

العمليات

سجل KYC

مرجع API

​حقول الهوية

​الحالة

​إجماليات الجلسات

​خريطة features

​طوابع النشاط الزمنية

​البيانات الوصفية

​العلاقات (غير مخزّنة في صف المستخدم)

​مثال على الاستجابة

​الخطوات التالية

العمليات

سجل KYC

مرجع API

حقول الهوية

الحالة

إجماليات الجلسات

خريطة `features`

طوابع النشاط الزمنية

البيانات الوصفية

العلاقات (غير مخزّنة في صف المستخدم)

مثال على الاستجابة

الخطوات التالية