--- title: نظرة عامة description: مرجع لواجهات برمجة تطبيقات IDCloud — عقدان عامان (Web & SDK وAPI). canonical: https://developer.unico.io/ar/dual-api/developers/api-reference/ locale: ar generated_by: markdown-export --- - [/ar/](/ar/) - مرجع API **في هذه الصفحة# نظرة عامة ### اختيار عقد​ اختيار العقد هو نتيجة **لمكان حدوث الالتقاط البيومتري** — وليس قرارًا مستقلًا. استخدم الجدول أدناه كدليل. العقداستخدمه عندما…الالتقاطالتدفق**[Web & SDK](/ar/dual-api/developers/api-reference/web-sdk)**رحلة الالتقاط مستضافة بواسطة Unico (iFrame ويب، إعادة توجيه، أو SDK أصلي)Unico يتحكميتم إنشاء العملية **قبل** الالتقاط ← يمر المستخدم بالرحلة ← تعود النتيجة عبر callback أو استطلاع**[API](/ar/dual-api/developers/api-reference/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` التفاصيل الكاملة في [البيئات](/ar/dual-api/developers/api-reference/environments). ### المصادقة​ تستخدم جميع عقود Unico **رمز Bearer (JWT)** يُحصل عليه عبر OAuth2 مع `urn:ietf:params:oauth:grant-type:jwt-bearer`. التفاصيل الكاملة في [المصادقة](/ar/dual-api/developers/api-reference/authentication). ### الاختلافات في الحمولة بين العقود​ تبدو العملية المفاهيمية نفسها ("إنشاء عملية التحقق من الهوية") مختلفة في كل عقد. استخدم الجداول أدناه كمرجع سريع عند الترحيل بين التكاملات. إنشاء العملية الجانبWeb & SDKAPI**نقطة النهاية**`POST /client/v1/process``POST /processes/v1`**المصادقة**`Authorization: Bearer ``Authorization: Bearer ` + `APIKEY`**الصورة**لا تُرسَل (يلتقطها مسار Unico)تُرسَل بصيغة `imageBase64`**تعريف المستخدم**`person.duiType` + `person.duiValue``subject.code` (CPF / CURP)**أنواع الوثائق**CPF، CURP، SSN، NIN، DNI، NIKCPF، CURP فقط**تعريف خط الأنابيب**`flow` (تعداد، أكثر من 30 قيمة)ضمني في `APIKEY` (القدرات)**Callback**`callbackUri` (إعادة توجيه المستخدم)لا شيء (متزامن)**Webhook**Webhook v1 (النتيجة النهائية)Webhook v1 (اختياري)**يُعيد عنوان URL للرحلة**نعم (`userRedirectUrl`)لا**النتيجة**غير متزامنة (GET استطلاع أو webhook)متزامنة (في الاستجابة)**رمز SDK**نعم (`token`، `webAppToken`)لا استرجاع النتيجة الجانبWeb & SDKAPI**نقطة النهاية**`GET /client/v1/process/\{id\}``GET /processes/v1/\{id\}` (أيضًا في استجابة الإنشاء)**الحالة**`state` + `result` (تعدادات مسبوقة)`status` (1، 3، 5)**هيكل النتيجة**متداخل تحت `process.authenticationInfo.{capability}Result`. في المكسيك، `idGov` تحت `authenticationInfo`.مسطح: `unicoId`، `liveness`، `government`، `identityFraudsters`، `idGov` (المكسيك فقط)**المستند**`services[].documents[]` (RG/CNH مع OCR)نقطة نهاية منفصلة (`GET /processes/v1/\{id\}/document`) ### ما التالي​ [المصادقة](/ar/dual-api/developers/api-reference/authentication) — تدفق OAuth2 وإنشاء JWT [البيئات](/ar/dual-api/developers/api-reference/environments) — sandbox مقابل الإنتاج [مجموعة Postman](/ar/dual-api/developers/api-reference/postman) — مجموعات جاهزة للاستخدام [Webhooks والأحداث](/ar/developers/webhooks-and-events) — تسليم النتائج غير المتزامن [SDKs والأدوات](/ar/developers/sdks-and-tools/overview) — Web SDK، Android، iOS، Flutter آخر تحديث في 8 أكتوبر 2026**