---
title: نظرة عامة
description: يُستخدم عندما يكون الالتقاط البيومتري مستضافاً من Unico (iFrame أو إعادة التوجيه أو SDK الأصلي).
canonical: https://developer.unico.io/ar/dual-api/developers/api-reference/web-sdk/
locale: ar
generated_by: markdown-export
---

يوثّق هذا القسم عقد **الويب والأجهزة الأصلية**، المستخدَم عندما تُفوّض تطبيقات العميل تنسيق الالتقاط إلى Unico.

## متى تستخدم هذا العقد

استخدم الويب والأجهزة الأصلية عندما:

- يُعيد تطبيقك **توجيه** المستخدم إلى رحلة مستضافة من Unico، سواء عبر Web Redirect أو iFrame مضمَّن.
- يستخدم تطبيقك **SDK أصلياً** (Android أو iOS أو Flutter) ويُفوِّض تجربة الالتقاط إلى Unico.
- تريد تلقّي النتائج **بشكل غير متزامن**، عبر webhook أو عن طريق جلب نتيجة العملية بعد الاكتمال.
- يتطلب التدفق **تخصيصاً من جهة الخادم** لرحلة المستخدم، كتحديد الخطوات أو تخصيص التجربة.

إذا التقط تطبيقك الصورة بالفعل وأراد إرسالها مباشرةً، استخدم [API](../api) بدلاً من ذلك.

## كيف يعمل التدفق

```mermaid
sequenceDiagram
    actor User
    participant Application
    participant Identity
    participant API as Unico Web

    User->>Application: Access your application
    Application->>Identity: Authenticate using the service account
    Identity-->>Application: Obtain the access-token
    Application->>API: POST request in Unico Web
    Note over Application,API: Send access-token + flow in request
    API-->>Application: Returns link to complete the journey
    Application-->>User: Render the link to user
    Note over User,Application: Render the link in your app<br/>or use Unico's messages

    User->>API: Makes the journey with Unico
    API-->>Application: Notify your service by Webhook or Callback
    Application->>API: GET request in Unico Web
    API-->>Application: Process response

    Note over Application: Take the decision
    Application-->>User: Feedback
```

## مرجع API

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

إنشاء عملية تحقق. تُعيد رابط رحلة ورموز SDK لتجربة الالتقاط المستضافة من Unico.

  **الحصول على نتيجة العملية**

استرداد الحالة الراهنة ونتيجة عملية التحقق.

  **الحصول على الصورة الشخصية**

استرداد الصورة الشخصية المائية الملتقَطة خلال رحلة التحقق.

  **الحصول على مجموعة الأدلة**

استرداد حزمة أدلة الالتقاط الكاملة لعملية ما — تُستخدم للتدقيق في الامتثال والتنظيم.

## تكامل العميل

  **تكامل الويب**

كيفية التكامل على جانب العميل — تدفقات إعادة التوجيه وإعداد iFrame SDK.

  **SDKs الجوّالة**

مكتبات أصلية لنظامَي Android وiOS وFlutter لإدارة تجربة الالتقاط داخل تطبيقك الجوّال.

## الخصائص الرئيسية

| الجانب | التفاصيل |
|---|---|
| **نقطة النهاية الرئيسية** | `POST /client/v1/process` |
| **الصورة عند الإنشاء** | لا تُرسَل — تُلتقَط داخل الرحلة المستضافة من Unico |
| **التعريف** | نوع الوثيقة ورقمها يُقدَّمان عند إنشاء العملية |
| **خط المعالجة** | يُحدَّد بنوع التدفق المختار عند إنشاء العملية |
| **الإعادة** | رابط الرحلة والرموز لـ SDK الأصلي |
| **النتيجة** | غير متزامنة — عبر webhook أو بالاستطلاع على نقطة نهاية النتيجة |
| **المصادقة** | رمز OAuth2 Bearer |
| **الدول المدعومة** | BR, MX, AR, ID, NG, US |