نظرة عامة

اختيار العقد هو نتيجة لمكان حدوث الالتقاط البيومتري — وليس قرارًا مستقلًا. استخدم الجدول أدناه كدليل.

العقد	استخدمه عندما…	الالتقاط	التدفق
Web & SDK	رحلة الالتقاط مستضافة بواسطة Unico (iFrame ويب، إعادة توجيه، أو SDK أصلي)	Unico يتحكم	يتم إنشاء العملية قبل الالتقاط ← يمر المستخدم بالرحلة ← تعود النتيجة عبر callback أو استطلاع
API	تتحكم تطبيقاتك في الالتقاط (مع أو بدون Unico SDK) وترسل الصورة مباشرة في الاستدعاء	العميل يتحكم	الصورة تُرسَل مع إنشاء العملية ← تعود النتيجة بشكل متزامن

العقد	مضيف Sandbox	مضيف الإنتاج
Web & SDK	`https://api.idcloud.uat.unico.app`	`https://api.idcloud.unico.app`
API	`https://api.id.uat.unico.app`	`https://api.id.unico.app`
OAuth2 / Token	`https://identityhomolog.acesso.io`	`https://identity.acesso.io`

التفاصيل الكاملة في البيئات.

تستخدم جميع عقود Unico رمز Bearer (JWT) يُحصل عليه عبر OAuth2 مع urn:ietf:params:oauth:grant-type:jwt-bearer.

التفاصيل الكاملة في المصادقة.

تبدو العملية المفاهيمية نفسها ("إنشاء عملية التحقق من الهوية") مختلفة في كل عقد. استخدم الجداول أدناه كمرجع سريع عند الترحيل بين التكاملات.

إنشاء العملية

الجانب	Web & SDK	API
نقطة النهاية	`POST /client/v1/process`	`POST /processes/v1`
المصادقة	`Authorization: Bearer <jwt>`	`Authorization: Bearer <jwt>` + `APIKEY`
الصورة	لا تُرسَل (يلتقطها مسار Unico)	تُرسَل بصيغة `imageBase64`
تعريف المستخدم	`person.duiType` + `person.duiValue`	`subject.code` (CPF / CURP)
أنواع الوثائق	CPF، CURP، SSN، NIN، DNI، NIK	CPF، CURP فقط
تعريف خط الأنابيب	`flow` (تعداد، أكثر من 30 قيمة)	ضمني في `APIKEY` (القدرات)
Callback	`callbackUri` (إعادة توجيه المستخدم)	لا شيء (متزامن)
Webhook	Webhook v1 (النتيجة النهائية)	Webhook v1 (اختياري)
يُعيد عنوان URL للرحلة	نعم (`userRedirectUrl`)	لا
النتيجة	غير متزامنة (GET استطلاع أو webhook)	متزامنة (في الاستجابة)
رمز SDK	نعم (`token`، `webAppToken`)	لا

استرجاع النتيجة

الجانب	Web & SDK	API
نقطة النهاية	`GET /client/v1/process/\{id\}`	`GET /processes/v1/\{id\}` (أيضًا في استجابة الإنشاء)
الحالة	`state` + `result` (تعدادات مسبوقة)	`status` (1، 3، 5)
هيكل النتيجة	متداخل تحت `process.authenticationInfo.{capability}Result`	مسطح: `unicoId`، `liveness`، `government`، `identityFraudsters`
المستند	`services[].documents[]` (RG/CNH مع OCR)	نقطة نهاية منفصلة (`GET /processes/v1/\{id\}/document`)