---
title: إعادة المعالجة واستيراد القاعدة البيومترية
description: دليل لإعادة معالجة السجلات البيومترية أو استيراد قاعدة بيومترية إلى منصة Unico.
canonical: https://developer.unico.io/ar/dual-api/resources/reprocessing
locale: ar
generated_by: markdown-export
---

- [/ar/](/ar/)
- الموارد
- إعادة المعالجة واستيراد القاعدة البيومترية

**في هذه الصفحة# إعادة المعالجة واستيراد القاعدة البيومترية

يغطي هذا الدليل كيفية إجراء **إعادة المعالجة** أو **استيراد القاعدة البيومترية** على منصة Unico. يوضح المتطلبات التقنية والتشغيلية لتكامل فعال وآمن يتبع أفضل ممارسات المنصة.
### النطاق​

تغطي هذه المادة نوعين من العمليات:

**إعادة المعالجة**: إعادة معالجة السجلات البيومترية للمستخدمين الذين مروا بالفعل عبر قاعدة العميل وقاعدة Unico لإعادة التقييم أو الترحيل بين الأنظمة.
**استيراد القاعدة البيومترية**: الرفع الأولي أو تحديث قاعدة تحتوي على صور سيلفي لأغراض التحقق من الهوية و/أو تصنيف المخاطر.
**استيراد قاعدة الوثائق**: رفع قاعدة وثائق إلى جانب صور السيلفي لأغراض التحقق عبر Facematch أو CPF Match (البرازيل فقط).

### المتطلبات المسبقة​

يجب أن يكون لدى العميل **عقد نشط أو اتفاقية عدم إفصاح موقعة** مع Unico وأن يكون في مرحلة التكامل (استثناء إذا تمت الموافقة من فريق الحوكمة).
سيتبع المشروع **اتفاقيات TPS (المعاملات في الثانية)** الرسمية. انظر [اتفاقية TPS](#tps-agreement) أدناه.
قبل الحصول على بيانات اعتماد الإنتاج، **يجب إجراء اعتماد التكامل الكامل** لضمان جودة البيانات وتوافق الحمولة والأداء المستقر.
يجب إنشاء **حساب خدمة مخصص** لإعادة المعالجة أو الاستيراد (مثال: "Reprocessing" أو "Legacy_Import").
سيتم إنشاء **مفتاح API مخصص** خصيصًا لإعادة المعالجة/الاستيراد.
**(اختياري)** يمكن إنشاء فرع مخصص لإعادة المعالجة/الاستيراد. يتم تحديد هذا المعامل في الحمولة باسم `subsidiaryId`. انظر [معاملات الحمولة](#payload-parameters) أدناه.
سيتم **إلغاء تنشيط** مفتاح API وحساب الخدمة بعد الفترة المتفق عليها أو اكتمال المعالجة.

### القدرات  المتاحة​

القدرةالوصف**التحقق من الهوية**يتحقق مما إذا كانت صورة السيلفي المقدمة تنتمي إلى المالك الفعلي للمعرّف.**تصنيف مخاطر الاحتيال**يتحقق من وجود سجل سلوك احتيالي مرتبط بهذا الوجه.**Facematch**يتحقق مما إذا كانت صورة الوثيقة تتطابق مع صورة السيلفي المقدمة.**CPF Match** Brazil onlyيتحقق مما إذا كان رقم CPF المقدم يتطابق مع رقم CPF المطبوع على الوثيقة. ملاحظة: لا تحتوي جميع وثائق RG على رقم CPF مطبوع.
### متطلبات صورة السيلفي​

يجب تقديمها بتنسيق **base64**.
يجب أن تتبع الصورة **معيار ICAO** (خلفية فاتحة، وجه في المنتصف، بدون إكسسوارات تعيق التعرف، إضاءة مناسبة).
الأبعاد الموصى بها: **1080x1920** (ع مودي) أو **1920x1080** (أفقي).
الحجم الأقصى: **800 كيلوبايت** (اضغط باستخدام JPEG 92 إذا لزم الأمر).
الاتجاه: **عمودي**.

### متطلبات الوثيقة​

**أنواع الوثائق المدعومة**: انظر [التقاط الوثائق وإعادة الاستخدام — الوثائق المدعومة](/ar/capabilities/document-reuse-and-capture#supported-documents).
يجب أن تشمل الصور كلاً من **الوجه والظهر** للوثيقة، مرئيَّين بالكامل دون قص.
يجب أن تكون الوثيقة **مقروءة** — واضحة، جيدة الإضاءة، وخالية من العوائق.

### اتفاقية TPS​

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

### التكامل​

#### نقاط النهاية​

البيئةعنوان URL الأساسيالوصولملاحظاتStaging`https://api.id.uat.unico.app`مفتوحإلزامي للاختبارProduction`https://api.id.unico.app`فقط بعد اعتماد الاعتماديتطلب تحكمًا صارمًا في TPS
#### الترويسات المطلوبة​

```
Authorization: Bearer {access_token}APIKEY: {your_api_key}Content-Type: application/json
```

#### معاملات الحمولة​

```
{  "subject": {    "duiType": 1,    "code": "11032395702",    "name": "User Name",    "email": "username@gmail.io",    "phone": "21998571922",    "birthDate": "30/07/1989",    "gender": "M"  },  "useCase": "Reprocessamento/Importação",  "subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819",  "imageBase64": "/9j/4AAQSkZJR...",  "document": {    "purpose": "Reprocessamento",    "documentId": "doc-001",    "files": [      {        "data": "doc_base64_frente",        "faceDocumentMatch": true      },      {        "data": "doc_base64_verso"      }    ]  }}
```

الحقلالنوعمطلوبالوصف`subject`objectنعمبيانات تعريف المستخدم.`subject.duiType`integerنعممعرّف نوع الوثيقة. انظر [قيم `duiType`](#duitype-values) أدناه.`subject.code`stringنعمCPF أو معرّف مستخدم آخر.`subject.name`stringنعمالاسم الكامل للمستخدم.`subject.email`stringلاالبريد الإلكتروني للمستخدم.`subject.phone`stringلارقم هاتف المستخدم.`subject.birthDate`stringلاتاريخ ميلاد المستخدم (`DD/MM/YYYY`).`subject.gender`stringلاجنس المستخدم (`M` أو `F`).`useCase`stringنعماسم حالة الاستخدام ("Reprocessamento" أو "Importação de base").`subsidiaryId`stringلامعرّف UUID للفرع (يقدمه Unico).`imageBase64`base64نعمصورة سيلفي المستخدم محولة إلى base64.`document`objectلابيانات الوثيقة المرتبطة بالعملية.`document.purpose`stringلاالغرض من الوثيقة (مثال: `"Reprocessamento"`).`document.documentId`stringلامعرّف الوثيقة.`document.files`arrayلاقائمة ملفات صور الوثيقة.`document.files[].data`base64لاصورة الوثيقة محولة إلى base64.`document.files[].faceDocumentMatch`booleanلايشير إلى ما إذا كان الوجه في الوثيقة يتطابق مع صورة السيلفي المقدمة.
**قيم `duiType`**الدولةالرمزالوصفAR6جواز سفر أرجنتينيAR7DNI الأرجنتينيAR49رخصة القيادة الأرجنتينية (Licencia Nacional de Conducir)AT34الرقم الضريبي النمساوي (STNR)BE36الرقم الوطني البلجيكي (NN)BR1CPF البرازيليBR5جواز سفر برازيليBR14CNPJ البرازيليCA28SIN الكنديCH33رقم AHV/AVS السويسريCL9RUN التشيليCL52جواز سفر تشيليCL57رخصة القيادة التشيلية (Licencia de Conducir)CO26NIT الكولومبيCO53جواز سفر كولومبيCO55رخصة القيادة الكولومبية (Licencia de Conducción)CO56بطاقة المواطنة الكولومبية (Cédula de Ciudadanía)DE41رقم التعريف الضريبي الألماني (IdNr)DK29CPR الدنماركيEC10NI الإكوادوريES50رقم هوية الأجانب الإسباني (NIE)ES51وثيقة الهوية الوطنية الإسبانية (DNI)FI35رمز الهوية الشخصية الفنلندي (HETU)FR46الرقم الضريبي المرجعي الفرنسي (SPI)GB30رقم التأمين الوطني البريطاني (NINO)GT12CUI الغواتيماليID16NIK الإندونيسيIE47رقم الخدمة العامة الشخصي الأيرلندي (PPSN)IT37Codice Fiscale الإيطالي (CF)LU48رقم الهوية الوطني اللوكسمبورغي (Matricule)MX2CURP المكسيكيMX25RFC المكسيكي (شخص طبيعي)MX58رخصة القيادة المكسيكية (Licencia de Conducir)NG8NIN النيجيريNG20رقم التحقق المصرفي النيجيري (BVN)NG43رمز BVN النيجيري (مُجزّأ)NG44رمز NIN النيجيري (مُجزّأ)NL42رقم خدمة المواطن الهولندي (BSN)NO39رقم الهوية الوطني النرويجي (Fødselsnummer)PE27RUC البيروفيPE40DNI البيروفيPE54جواز سفر بيروفيPL31PESEL البولنديPT45رقم التعريف الضريبي البرتغالي (NIF)SE32الرقم الشخصي السويدي (PNR)SE38الرقم التنسيقي السويدي (Samordningsnummer)TR24رقم الهوية التركي (TCKN)US4SSN الأمريكيUS11جواز سفر أمريكيUS18رخصة قيادة أمريكيةUS21بطاقة جواز سفر أمريكيةUS22جواز سفر أمريكي مصنوع من البولي كاربوناتUS23بطاقة هوية أمريكيةUY13CI الأوروغويانيZZ15عنوان البريد الإلكترونيZZ17رقم الهاتف—0غير محدد—3معرّف Unico الداخلي
#### ملاحظات مهمة​

يجب أن تتوافق صورة السيلفي مع **معيار ICAO** بجودة وإضاءة مناسبة.
يجب أن تكون صورة السيلفي بتنسيق **base64**.
تجنب الإرسال الجماعي بدون تحكم في TPS — قد يؤدي ذلك إلى تفعيل تحديد المعدل (انظر [معالجة الأخطاء](#error-handling) أدناه).
اختبر البيانات والتكامل دائمًا في بيئة Staging أولاً.

#### الاستجابات​

**نجاح — 200 OK**
بدون وثيقةمع وثيقة (Facematch)```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 3,  "unicoId": {    "result": "inconclusive"  },  "identityFraudsters": {    "result": "inconclusive"  }}
```

الحقلالنوعالوصف`id`stringمعرّف العملية. احفظه للاستعلامات المستقبلية أو إذا قمت بتطبيق التحقق (1:1) لاحقًا.`status`integerحالة المعاملة.`unicoId.result`stringاستجابة قدرة التحقق من الهوية.`identityFraudsters.result`stringاستجابة قدرة تصنيف مخاطر الاحتيال.```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "score": 0,  "status": 3,  "unicoId": {    "result": "yes"  },  "faceDocumentMatch": {    "faceMatch": true  },  "identityFraudsters": {    "result": "yes"  }}
```

الحقلالنوعالوصف`id`stringمعرّف العملية. احفظه للاستعلامات المستقبلية أو إذا قمت بتطبيق التحقق (1:1) لاحقًا.`status`integerحالة المعاملة.`score`numberنتيجة Facematch.`unicoId.result`stringاستجابة قدرة التحقق من الهوية.`faceDocumentMatch.faceMatch`booleanما إذا كانت صورة الوثيقة تتطابق مع صورة السيلفي المقدمة.`identityFraudsters.result`stringاستجابة قدرة تصنيف مخاطر الاحتيال.
**خطأ في معالجة الصورة**
```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 5}
```

**الأخطاء الشائعة**
تشير الرموز في نطاق `4xx` إلى أخطاء في التحقق من البيانات المقدمة. تشير الرموز في نطاق `5xx` إلى أعطال من جانب الخادم.
رمز HTTPنوع الخطأالسبب المحتملالإجراء الموصى به`400`Bad Requestحمولة غير صالحةتحقق من البنية والمحتوى.`401`Unauthorizedرمز مميز منتهي الصلاحية أو غير صالحأعد إنشاء الرمز المميز.`403`Forbiddenمفتاح API غير صحيح أو صلاحيات غير كافيةتحقق من بيانات الاعتماد.`429`Too Many Requestsتم تجاوز معدل الطلباتانتظر والتزم بحد TPS.`500+`Internal Server Errorعطل داخليأعد المحاولة بعد بضع ثوانٍ؛ افتح تذكرة إذا استمرت المشكلة.
### معالجة الأخطاء​

يجب مراقبة **حد المعدل (HTTP 429)** بعناية. قد يؤدي التحميل الزائد للطلبات إلى حظر خط المعالجة.
التزم دائمًا بمعدل TPS المتفق عليه مع Unico (انظر [اتفاقية TPS](#tps-agreement)).
للأعطال المستمرة (5xx)، أعد المعالجة مع التحكم في إعادة المحاولة/التراجع.
آخر تحديث في 8 أكتوبر 2026**