> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

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

> كل حقل في كيان المستخدم في Didit: الهوية والحالة وتجميعات جلسات KYC والبيانات البيومترية والنشاط والبيانات الوصفية. تسعير حسب الاستخدام.

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

## حقول الهوية

| الحقل | النوع | الوصف |
| - | - | - |
| `uuid` | UUID | المفتاح الأساسي الذي يعيّنه Didit. ثابت وفريد. |
| `didit_internal_id` | string | معرّف داخلي مقروء للإنسان (يظهر في استجابات API). |
| `vendor_data` | string | معرّفك الخاص للمستخدم. فريد لكل تطبيق. [اقرأ المزيد](https://docs.didit.me/ar/entities/vendor-data-linking.md). |
| `display_name` | string | اسم بديل يظهر في الكونسول. يُستخدم `full_name` أو `vendor_data` افتراضياً إذا لم يُضبط. |
| `full_name` | string | الاسم القانوني الكامل المأخوذ من مستند الهوية في آخر جلسة تحقق من المستخدمين (KYC) مقبولة. |
| `date_of_birth` | date (ISO 8601) | مأخوذ من آخر جلسة تحقق من المستخدمين (KYC) مقبولة. |
| `portrait_image` | URL | رابط S3 موقّع لصورة السيلفي من آخر كشف حيوية مقبول. |

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

## الحالة

| الحقل | النوع | القيم | الوصف |
| - | - | - | - |
| `status` | enum | `ACTIVE`, `FLAGGED`, `BLOCKED` | يتحكم في تطبيق القيود على الجلسات والمعاملات المستقبلية. انظر [دورة الحياة](https://docs.didit.me/ar/entities/lifecycle.md). |

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

تحسب 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 | عناوين البريد الإلكتروني الموثّقة عبر [التحقق من البريد الإلكتروني](https://docs.didit.me/ar/core-technology/email-verification/overview.md) |
| `approved_phones[]` | array of strings | أرقام الهاتف الموثّقة عبر [التحقق من رقم الهاتف](https://docs.didit.me/ar/core-technology/phone-verification/overview.md) |
| `features` | object | آخر حالة لكل ميزة عبر جميع الجلسات |

### خريطة `features`

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

```json theme={null}
{
  "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](https://docs.didit.me/ar/management-api/lists/overview.md): صفِّ الإدخالات حسب معرّفات المستخدم |

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

```json theme={null}
{
  "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" }
}
```

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

> [card] [العمليات](https://docs.didit.me/ar/entities/users/operations.md)
>
> الإنشاء والتحديث وتغيير الحالة والحذف.

> [card] [سجل KYC](https://docs.didit.me/ar/entities/users/kyc-history.md)
>
> استرجاع كل جلسة مرتبطة بالمستخدم.

> [card] [مرجع API](https://docs.didit.me/ar/management-api/users/get.md)
>
> مخطط GET /v3/users/{vendor_data}/.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.