---
title: نظرة عامة
description: دليل خطوة بخطوة لدمج Human Token — من المصادقة إلى استرداد أول humanToken.
canonical: https://developer.unico.io/ar/human-token/api-reference/overview
locale: ar
generated_by: markdown-export
---

- [/ar/](/ar/)
- مرجع API
- نظرة عامة

**في هذه الصفحةنظرة عامة على مرجع APIكل ما تحتاجه للانتقال من الصفر إلى أول humanToken.

يحتوي Human Token على ثلاث نقاط نهاية. توضح هذه الصفحة كيف تتكامل معاً حتى تتمكن من بدء الدمج على الفور.
### عنوان URL الأساسي​

البيئةعنوان URL الأساسي**الإنتاج**`https://humantoken.unico.app`
تتطلب جميع الطلبات ترويسة `x-unico-accesskey`. راجع [المصادقة](/ar/human-token/get-started/authentication) لإنشاء مفتاحك.

### تدفق البدء السريع​

### الخطوة 1 — المصادقة​

قم بإنشاء `x-unico-accesskey` الخاص بك في [Human Dashboard](https://dashboard.unico.app) أو عبر [Authentication API](/ar/human-token/get-started/authentication). يستخدم كل طلب أدناه هذا المفتاح.
```
x-unico-accesskey: uip_ak.prod.a1b2c3d4.e5f6g7h8.i9j0k1l2
```

### الخطوة 2 — إنشاء عملية​

اتصل بـ [Create Process](/ar/human-token/api-reference/post-processes) لبدء التحقق. اختر أحد النموذجين:
النموذجالتدفقاتكيف يعمل**API Only**`api+humantoken`, `api+liveness+humantoken`, `api+liveness+humantoken+revalidation`يرسل الخادم الخلفي صورة السيلفي كـ `imageBase64`. يعود `humanToken` في نفس الاستجابة.**Human Token Journey**`humantoken`, `humantoken+revalidation`يكمل المستخدم الالتقاط على منصة Unico. تحصل على `token` و `link` لعرض الرحلة، ثم تجلب النتيجة باستخدام Get Process.
**مثال API Only:**
```
curl -X POST https://humantoken.unico.app/client/v1/process \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY" \  -H "Content-Type: application/json" \  -d '{    "flow": "api+humantoken",    "imageBase64": "<base64-encoded-selfie>",    "companyBranchId": "<your-branch-id>"  }'
```

**مثال Human Token Journey:**
```
curl -X POST https://humantoken.unico.app/client/v1/process \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY" \  -H "Content-Type: application/json" \  -d '{    "flow": "humantoken",    "callbackUri": "https://yourapp.com/callback",    "companyBranchId": "<your-branch-id>"  }'
```

راجع [Create Process](/ar/human-token/api-reference/post-processes) لجميع التدفقات والمعلمات وتفاصيل الاستجابة.

### الخطوة 3 — عرض الرحلة للمستخدم (تدفقات Journey فقط)​

بالنسبة لتدفقات `humantoken` و `humantoken+revalidation`، تتضمن استجابة Create Process:

**`token`** — يقوم بتهيئة [Web SDK](/ar/human-token/integrations/web/web-integration/) أو الدمج الأصلي
**`link`** — عنوان URL لإعادة توجيه المستخدم إليه

اختر الدمج المناسب لمنصتك:
المنصةالنهج**Web — SDK**قم بتضمين الرحلة مباشرة باستخدام `idpay-b2b-sdk` → [Web Integration](/ar/human-token/integrations/web/web-integration/)**Web — Redirect**أعد توجيه المستخدم إلى `link` → [Web Integration](/ar/human-token/integrations/web/web-integration/)**Android**Custom Tabs → [Android](/ar/human-token/integrations/app/android)**iOS**ASWebAuthenticationSession → [iOS](/ar/human-token/integrations/app/ios)**Ionic**Capacitor plugin → [Ionic](/ar/human-token/integrations/app/ionic)**React Native**Native module → [React Native](/ar/human-token/integrations/app/react-native)**Flutter**Platform Channels → [Flutter](/ar/human-token/integrations/app/flutter)
عندما تنتهي الرحلة، يعود المستخدم إلى `callbackUri` الخاص بك. انتقل إلى الخطوة 4.
تدفقات API Onlyتخطَّ هذه الخطوة — النتيجة موجودة بالفعل في استجابة Create Process.

### الخطوة 4 — استرداد النتيجة (تدفقات Journey فقط)​

اتصل بـ [Get Process](/ar/human-token/api-reference/get-process) باستخدام معرف العملية `id` لجلب النتيجة:
```
curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"
```

تتضمن الاستجابة `data.humanToken.value` (التدفقات القياسية) أو `data.humanTokenMatch` (تدفقات إعادة التحقق). راجع [Get Process](/ar/human-token/api-reference/get-process) للاطلاع على مخطط الاستجابة الكامل وقيم الحالة.

### الخطوة 5 — استخدام humanToken​

`humanToken` هو معرّف ثابت ومبهم (حتى 100 حرف). يُحلّ الشخص نفسه دائماً إلى نفس القيمة.
```
const { humanToken } = process.data;if (!humanToken?.value) {  // Inconclusive — retry or reject per your business rules  return;}const existing = await db.persons.findByHumanToken(humanToken.value);if (existing) {  // Same person seen before — returning user or duplicate} else {  // First time — create a new record  await db.persons.create({ humanToken: humanToken.value });}
```

تحذيرتحقق دائماً من أن `data.humanToken.value` ليست فارغة قبل تخزينها أو مطابقتها.

### الخطوة 6 — استرداد صورة السيلفي (اختياري)​

اتصل بـ [Get Selfie](/ar/human-token/api-reference/get-selfie) لتنزيل الصورة الملتقطة. تكون صورة السيلفي متاحة لمدة **24 ساعة** بعد انتهاء العملية — بعد ذلك يتم حذفها نهائياً.
```
curl https://humantoken.unico.app/client/v1/process/$PROCESS_ID/selfie \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"
```

راجع [Get Selfie](/ar/human-token/api-reference/get-selfie) لتفاصيل الاستجابة ورموز الخطأ.

### نقاط النهاية في لمحة​

الطريقةنقطة النهايةالوصف`POST``/client/v1/process`[Create Process](/ar/human-token/api-reference/post-processes) — بدء عملية تحقق`GET``/client/v1/process/{processId}`[Get Process](/ar/human-token/api-reference/get-process) — جلب النتيجة`GET``/client/v1/process/{processId}/selfie`[Get Selfie](/ar/human-token/api-reference/get-selfie) — تنزيل السيلفي (24 ساعة)
### ما التالي​

[Create Process](/ar/human-token/api-reference/post-processes) — مرجع كامل للمعلمات لجميع التدفقات الخمسة
[Authentication](/ar/human-token/get-started/authentication) — إنشاء وإدارة مفاتيح الوصول
[Build With LLM](/ar/human-token/api-reference/build-with-llm) — الصق موجهاً في مساعد الذكاء الاصطناعي لإنشاء الدمج الكامل
آخر تحديث في 22 أكتوبر 2026**