> ## 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.

# طرق المطابقة 1x1 و 2x2 في التحقق من قواعد البيانات

> تحدد Didit نتائج مطابقة 1x1 و 2x2 عبر عتبات مطابقة الأسماء وقواعد partialMatchAction والمنطق التتابعي. بدءاً من $0.05/check.

تتحقق واجهة API لـ [التحقق من قواعد البيانات](https://docs.didit.me/ar/core-technology/database-validation/overview.md) من Didit من بيانات الهوية عبر مقارنتها بالسجل المدني المعتمد أو الهيئة الضريبية أو القوائم الانتخابية لكل دولة — مثل RENAPER (الأرجنتين)، وReceita Federal (البرازيل)، وTribunal Electoral (بنما)، وRENAPO (المكسيك)، وJunta Central Electoral (جمهورية الدومينيكان)، وRegistraduría Nacional (كولومبيا) وغيرها. وتتم فوترة كل استعلام لكل استدعاء ناجح، بدءاً من **\$0.05/فحص** بدون حد أدنى شهري.

تُشتق النتائج من نتائج كل خدمة: **1×1** عندما يُرجع سجل واحد تطابقاً كاملاً، و**2×2** عندما يؤكد سجلان مستقلان صحة البيانات. توثق هذه الصفحة كيفية احتساب هذه النتائج، وحدود التطابق التقريبي المطبقة على الأسماء، ومنطق اتخاذ القرار الذي يحكم `partialMatchAction` و`noMatchAction` في قواعد سير العمل لديك.

## مطابقة 1×1

تتضمن هذه الطريقة مطابقة نقطة بيانات مدخلة واحدة (عادةً ما تكون رقم الهوية الوطنية أو معرّفاً مشابهاً) مع قاعدة بياناتنا. إذا تم العثور على تطابق مباشر، فإننا نؤكد الهوية. ومع ذلك، إذا فشلت المحاولة الأولى، فقد نجرب مصادر بيانات موثوقة بديلة بتسلسل متتابع. ويعني هذا أننا نواصل التحقق عبر مزودين متعاقبين حتى نحقق تطابقاً أو نستنفد جميع الخيارات. ومن المهم الإشارة إلى أن التطابق الجزئي لا يوقف العملية—بل نتوقف فقط بمجرد العثور على تطابق كامل وحاسم أو التأكد من عدم وجود أي تطابق.

يتطلب منطق مطابقة 1x1 مطابقة البيانات الشخصية للمستخدم مع مصدر واحد للحصول على تطابق كامل لهويته.\*

| نتيجة التحقق | فئة الاسم | فئة رقم الهوية | فئة تاريخ الميلاد |
| :- | :- | :- | :- |
| تطابق كامل | تطابق كامل | تطابق كامل | أي قيمة |
| تطابق جزئي | تطابق جزئي | تطابق كامل | أي قيمة |
| لا يوجد تطابق | جميع التوليفات الأخرى | | |

*\*تُفحص مصادر الدولة المعنية حتى يتم التوصل إلى تطابق كامل للهوية. وإذا لم يتم العثور على تطابق كامل، يقوم النظام بعد ذلك بفحص تلك المصادر بشكل متكرر للبحث عن تطابق جزئي لهوية المستخدم.*

> [!NOTE]
>
> يصف جدول 1×1 أعلاه وجدول 2×2 أدناه النموذج العام، وليس ضماناً ينطبق على كل خدمة. تختلف الحقول الحاسمة باختلاف الخدمة والمدخلات الاختيارية التي ترسلها: إذ لا يمكن للسجل سوى مقارنة الحقول التي يحتفظ بها والحقول التي تزوده بها، وتتحدد نتيجة الخدمة من خلال الحقول التي تقارنها فعلياً. لا تقارن كل خدمة رقم الهوية، وبعضها يقارنه فقط عند إرساله. على سبيل المثال، يتطلب [إسبانيا - التحقق من DNI/NIE](https://docs.didit.me/ar/api-reference/database-validation/spain/dni.md) (`esp_dni`) الاسم وتاريخ الميلاد والعنوان، ويأخذ `national_id` كمدخل اختياري. وهو يقارن دائماً الاسم وتاريخ الميلاد والعنوان، كما يقارن أيضاً رقم الهوية عند إرسال `national_id`.
>
> الحقل المطلوب ليس بالضرورة حقلاً حاسماً، في حين يمكن للحقل الاختياري أن يكون كذلك. يجب إرسال الحقل المطلوب حتى يتم قبول الطلب، والحقل المدرج في `source_data` يمثل بيانات أعادها السجل. ولا يوضح أي منهما الحقول التي حسمت النتيجة. توضح أمثلة الاستجابة في صفحة كل خدمة استجابة واحدة محتملة، لذا فإن مفاتيح كائن `validation` الخاص بها ليست قائمة كاملة بالحقول التي تقارنها تلك الخدمة. تسرد صفحة مرجع API الخاصة بكل خدمة، المدرجة تحت [الدول والخدمات المدعومة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-supported-countries.md)، مدخلاتها المطلوبة والاختيارية تحت **المدخلات**.

## مطابقة 2×2

تتطلب هذه الطريقة مطابقة نقطتي بيانات مُدخلتين (مثل: الاسم + تاريخ الميلاد، أو الهوية الوطنية + رقم الهاتف) مع حقلين مقابلين في قاعدة بياناتنا. تماماً كما هو الحال مع مطابقة 1x1، نتبع أسلوب الشلال، حيث نستعلم من عدة مصادر بيانات بشكل تسلسلي. نواصل العملية عبر كل خطوة حتى نجد تطابقاً كاملاً عبر كلا حقلي البيانات. لا تكفي التطابقات الجزئية أو التطابقات في حقل واحد؛ إذ تستمر عملية التحقق حتى يتم تحقيق تطابق حاسم في حقلين أو فحص جميع المصادر.

يتطلب منطق مطابقة 2x2 مطابقة البيانات الشخصية للمستخدم مقابل مصدرين للحصول على تطابق كامل لهويته.\*

| نتيجة التحقق | مصدر البيانات الأول | مصدر البيانات الثاني |
| :- | :- | :- |
| تطابق كامل | الاسم تطابق كامل + الهوية الوطنية تطابق كامل | الاسم تطابق كامل + الهوية الوطنية تطابق كامل |
| تطابق كامل | الاسم تطابق كامل + الهوية الوطنية تطابق كامل | الاسم تطابق جزئي + الهوية الوطنية تطابق كامل |
| تطابق كامل | الاسم تطابق كامل + الهوية الوطنية تطابق كامل | الاسم تطابق كامل + تاريخ الميلاد تطابق كامل |
| تطابق كامل | الاسم تطابق كامل + الهوية الوطنية بأي قيمة كانت | الاسم تطابق كامل + الهوية الوطنية بأي قيمة كانت |
| تطابق جزئي | الاسم تطابق كامل + الهوية الوطنية تطابق كامل | |
| تطابق جزئي | الاسم تطابق جزئي + الهوية الوطنية تطابق كامل | |
| تطابق جزئي | الاسم تطابق تام + تاريخ الميلاد تطابق تام | |
| تطابق جزئي | الاسم تطابق تام + رقم الهوية الوطنية بأي قيمة | |
| لا يوجد تطابق | جميع التوليفات الأخرى | |

*\*يتم فحص مصادر الدولة المعنية حتى يتم العثور على تطابق تام لهوية المستخدم. وإذا لم يتم العثور على تطابق تام، يقوم النظام بعد ذلك بفحص تلك المصادر بشكل متكرر بحثاً عن تطابق جزئي لهوية المستخدم.*

***

## مطابقة فئات وسمات البيانات

فيما يلي السيناريوهات التي تؤدي إلى تطابق تام لفئات بيانات الاسم، وتاريخ الميلاد، والهوية. ولا يمكن حدوث تطابق جزئي إلا لفئة الاسم فقط.

### مطابقة فئة الاسم

يُعتبر هناك **تطابق تام** في فئة الاسم عند استيفاء أيٍّ من سيناريوهات مطابقة سمات البيانات التالية:

* دمج الاسم الكامل تطابق تام (الاسم الأول + اسم العائلة مدمجين بحد تشابه يبلغ 85%)
* الاسم الأول تطابق تام + اسم العائلة تطابق تام
* الاسم الأول تطابق تام + الاسم من جهة الأم تطابق تام
* الاسم الأول تطابق تام + الاسم من جهة الأب تطابق تام

يُعتبر هناك **تطابق جزئي** في فئة الاسم عند استيفاء أيٍّ من سيناريوهات مطابقة سمات البيانات التالية:

* الاسم الأول تطابق تام
* اسم العائلة تطابق تام
* الاسم من جهة الأب تطابق تام
* الاسم من جهة الأم تطابق تام
* الاسم من جهة الأم تطابق تام + الاسم من جهة الأب تطابق تام

### مطابقة فئة تاريخ الميلاد

يُعدّ **تطابق تام** في فئة تاريخ الميلاد فقط عند استيفاء سيناريو مطابقة سمات البيانات التالي:

* سنة الميلاد تطابق تام + شهر الميلاد تطابق تام + يوم الميلاد تطابق تام

لا يمكن حدوث تطابق جزئي في فئة تاريخ الميلاد.

### مطابقة فئة الهوية

يُعدّ **تطابق تام** في فئة الهوية فقط عند استيفاء سيناريو مطابقة سمات البيانات التالي:

* رقم الهوية تطابق تام

لا يمكن حدوث تطابق جزئي في فئة الهوية.

لا تُحتسب فئة الهوية إلا عندما تقارن الخدمة رقم الهوية. فبعض الخدمات لا تقارنه أبداً، وبعضها يقارنه فقط عندما ترسله كمدخل.

***

## المطابقة التقريبية لسمات البيانات

فيما يلي معايير المطابقة التقريبية لمختلف سمات البيانات مقارنةً بمصادر الدول.

* **سمات بيانات الاسم**
  لكي تُحقّق سمة بيانات من فئة الاسم نتيجة تطابق كامل، يجب أن تكون ضمن حد تشابه يبلغ 70% للأحرف، محسوباً بخوارزمية Levenshtein مقارنةً بالسجلات الموجودة في مصادر البيانات. وبالنسبة لدمج الاسم الكامل (الاسم الأول + اسم العائلة معاً)، يُستخدم حد أعلى بنسبة تشابه تبلغ 85%. على سبيل المثال، إذا كانت مدخلات سمة الاسم هي 'Christophel' وكان الاسم الفعلي هو 'Christopher'، فسيتم إرجاع تطابق كامل بناءً على منطق المطابقة التقريبية. ينطبق هذا النظام على سمات بيانات *الاسم الأول* و\_اسم العائلة\_ و\_اسم الأب\_ و\_اسم الأم\_.

* **سمات بيانات تاريخ الميلاد والهوية**
  لا نستخدم أي نوع من المطابقة التقريبية على سمات البيانات ضمن فئات بيانات تاريخ الميلاد أو الهوية. يُشترط وجود تطابق تام لهذه الحقول.

### أمثلة

فيما يلي أمثلة على مدخلات سمات البيانات التي تستوفي معايير منطق المطابقة التقريبية وتُحقّق تطابق كامل.

| سمة البيانات | المدخلات | سجل مصدر البيانات | النتيجة |
| :- | :- | :- | :- |
| first\_name | Christopher | Christopher | تطابق كامل |
| first\_name | Christophel | Christopher | تطابق كامل |
| first\_name | Chris | Christopher | لا يوجد تطابق |
| last\_name | Smith | Smith | تطابق كامل |
| last\_name | Smyth | Smith | تطابق كامل |
| last\_name | Smitty | Smith | لا يوجد تطابق |

## انظر أيضاً

* [نظرة عامة على التحقق من قواعد البيانات](https://docs.didit.me/ar/core-technology/database-validation/overview.md) — كيفية عمل API من البداية إلى النهاية، والسجلات المدعومة، والأسعار.
* [رموز النتائج](https://docs.didit.me/ar/core-technology/database-validation/database-validation-outcome-codes.md) — القائمة الكاملة لرموز استجابة المزود (متوفى، قاصر، لم يتم العثور على المستند، عدم تطابق بيومتري).
* [التحذيرات](https://docs.didit.me/ar/core-technology/database-validation/database-validation-warnings.md) — ما نعرضه عندما يتعذر تشغيل الخدمة بسبب مدخلات مفقودة.
* [الدول والخدمات المدعومة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-supported-countries.md) — جميع السجلات النشطة، والحقول المطلوبة، وسعر كل استدعاء.
* [التقارير](https://docs.didit.me/ar/core-technology/database-validation/database-validation-report.md) — عمليات تصدير الفوترة الشهرية لكل خدمة.


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