---
title: نظرة عامة
description: عقد API — يُستخدم عندما يتحكم العميل في الالتقاط ويرسل الصورة مباشرة في الطلب.
canonical: https://developer.unico.io/ar/dual-api/developers/api-reference/api/
locale: ar
generated_by: markdown-export
---

يوثّق هذا القسم عقد **API**، الذي يُستخدم عندما تمتلك تطبيقات العميل خطوة الالتقاط وترسل الصورة مباشرةً إلى المنصة.

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

استخدم عقد API عندما:

- قام تطبيقك **بالتقاط السيلفي أو الصورة بالفعل** (عبر SDK الأصلي لـ Unico أو حزمة خاصة — [معيار الالتقاط](/developers/sdks-and-tools/capture-standard)).
- تريد **نتائج متزامنة** في استجابة إنشاء العملية ذاتها.
- **لا** تريد توجيه المستخدم إلى رحلة مستضافة.
- تفضل بنيتك مكالمات خادم إلى خادم التقليدية (طلب ← استجابة بالنتيجة).

إذا أردت من Unico استضافة الرحلة، استخدم [Web & SDK](../web-sdk) بدلاً من ذلك.

## مرجع API

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

إنشاء عملية تحقق بإرسال الصورة الملتقطة مباشرة. تُرجع نتيجة متزامنة.

  **استرداد عملية**

استرداد عملية موجودة باستخدام عقد API عبر معرّفها.

  **استرداد المستندات القابلة لإعادة الاستخدام**

التحقق مما إذا كان المستخدم لديه بالفعل مستند قابل لإعادة الاستخدام قبل بدء تدفق التقاط جديد.

  **إنشاء عملية مستند**

التقاط مستند جديد أو إعادة استخدام مستند ملتقط مسبقاً مرتبط بعملية بيومترية.

  **التحقق من البيانات**

الاستعلام عن بيانات التسجيل وفحص الأشخاص المعرّضين سياسياً/غسيل الأموال والعلاقة الرياضية لرقم CPF معين.

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

  **SDKs الأصلية**

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

  **معيار الالتقاط**

المتطلبات التقنية التي يجب أن يستوفيها الالتقاط الخاص بك عند عدم استخدام SDK لـ Unico — الدقة والتنسيق والإضاءة والمزيد.

### الفروق عن Web & SDK

| الجانب | API | Web & SDK |
|---|---|---|
| **وقت إنشاء العملية** | بعد الالتقاط | قبل الالتقاط |
| **إعادة الصورة** | فورية (بعد الالتقاط من جانب العميل) | عبر نقطة نهاية مخصصة |
| **التحكم في الرحلة** | العميل | Unico |
| **التحكم في الالتقاط** | العميل (بأو بدون SDK) | Unico |
| **التعريف** | `subject.code` | `person.duiType` + `person.duiValue` |
| **الرؤوس** | `Authorization` + `APIKEY` | `Authorization` فقط |
| **مخطط النتيجة** | مسطح (`unicoId.result`، `liveness`، إلخ.) | متداخل (`process.authenticationInfo.*Result`) |

### الخطوات التالية

- [إنشاء عملية](./post-processes) — عقد الإعداد الكامل.
- [رموز الخطأ](../error-codes) — التعامل مع استجابات 4xx و5xx.