---
title: الحصول على العملية
description: استرجاع عملية Human Token وقيمة humanToken الخاصة بها بواسطة معرّف العملية — بعد Human Token Journey، أو لإعادة الاستعلام عن نتيجة API Only.
canonical: https://developer.unico.io/ar/human-token/api-reference/get-process
locale: ar
generated_by: markdown-export
---

- [/ar/](/ar/)
- مرجع API
- الحصول على العملية

**في هذه الصفحةالحصول على العمليةGETاسترجع عملية Human Token بواسطة معرّفها — بعد عودة المستخدم من Human Token Journey، أو لإعادة الاستعلام عن نتيجة API Only.

### نقطة النهاية​

البيئةالرابط**الإنتاج**`GET https://humantoken.unico.app/client/v1/process/{processId}`
### الطلب​

Headers
Headerالقيمة`x-unico-accesskey``<your_access_key>` (راجع [المصادقة](/ar/human-token/get-started/authentication))
معاملات المسار (Path)
المعاملالنوعمطلوبالوصف`processId`string (UUID)نعممعرّف العملية الذي تُعيده [إنشاء عملية](/ar/human-token/api-reference/post-processes).
### مثال​

cURLNode.js```
curl -X GET https://humantoken.unico.app/client/v1/process/$PROCESS_ID \  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"
```

```
import fetch from 'node-fetch';const res = await fetch(  `https://humantoken.unico.app/client/v1/process/${processId}`,  { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } });const result = await res.json();// result.data.humanToken.value
```

### الاستجابات​

200 OK
للاستجابة التنسيق نفسه الخاص بـ [إنشاء عملية](/ar/human-token/api-reference/post-processes#responses). يعتمد شكل `data` على التدفق المستخدم عند إنشاء العملية.
**التدفقات القياسية** (`api+humantoken`، `api+liveness+humantoken`، `humantoken`):
```
{  "id": "6ed74799-4c2f-4023-b43f-a73cf7c847b2",  "state": "PROCESS_STATE_FINISHED",  "data": {    "humanToken": {      "value": "3f9a1c7e5b2d4086a1e3c5f7092b4d6e8a0c2e4f6183a5c7e9b1d3f5072a4c6e",      "status": "validated"    }  }}
```

**تدفقات إعادة التحقق** (`api+liveness+humantoken+revalidation`، `humantoken+revalidation`):
```
{  "id": "cb0472c0-6dbc-46c6-b830-2be7edc35424",  "state": "PROCESS_STATE_FINISHED",  "data": {    "humanTokenMatch": "true"  }}
```

الحقلالنوعالوصف`id`string (UUID)معرّف العملية.`state`stringحالة العملية — راجع [قيم `state`](#state-values).`data.​humanToken.​value`stringالتدفقات القياسية فقط. معرّف مستقر وغير شفاف للوجه (حتى 100 حرف). يُحلَّل الشخص ذاته دائمًا إلى القيمة نفسها.`data.​humanTokenMatch`stringتدفقات إعادة التحقق فقط. `"true"` إذا تطابقت الصورة الشخصية مع `humanToken` المرجعي، و`"false"` في حال عدم التطابق.
قيم state
القيمةالمعنى`PROCESS_STATE_UNSPECIFIED`الحالة غير محددة.`PROCESS_STATE_CREATED`تم إنشاء العملية ولا تزال تقبل جلسات جديدة. تكون `data` بالقيمة `{}`.`PROCESS_STATE_FINISHED`اكتملت العملية ولم تعد تقبل جلسات جديدة. في التدفقات القياسية، يكون `data.humanToken` موجودًا عند إنشاء Human Token؛ وفي تدفقات إعادة التحقق، يُشير `data.humanTokenMatch` إلى ما إذا كانت الصورة الشخصية تتطابق مع الرمز المرجعي. وإلا تكون `data` بالقيمة `{}`.`PROCESS_STATE_FAILED`فشلت العملية. تكون `data` بالقيمة `{}`.`PROCESS_STATE_CANCELED`أُلغيت العملية. تكون `data` بالقيمة `{}`.`PROCESS_STATE_AWAITING_FOR_DOCUMENT`العملية بانتظار وثيقة هوية. تكون `data` بالقيمة `{}`.
تحذيرتحقق دائمًا من أن `data.humanToken.value` ليست فارغة قبل استخدامها.
### رموز الأخطاء​

400 Bad Request401 Unauthorized404 Not Found429 Too Many Requests500 Internal Server Errorالرمزالرسالةالوصف`3`process id is invalidعندما يكون معرّف العملية غير صالح.مفتاح الوصول مفقود أو غير صالح في الترويسة `x-unico-accesskey`. راجع [المصادقة](/ar/human-token/get-started/authentication).الرمزالرسالةالوصف`5`error getting process: rpc error: code = NotFound desc = process not foundعندما لا يُعثر على معرّف العملية.تم الوصول إلى حد المعدل. عندما يتلقى نظامك خطأ HTTP 429، يجب عليك تطبيق آليات لمنع حالات الفشل المتتالية وتجنب تفاقم القيود.
**أفضل الممارسات:**

**فترة التهدئة (backoff):** أوقف أو قلل الطلبات اللاحقة من نظامك فورًا. لا تعد محاولة الطلبات الفاشلة باستمرار في حلقة متكررة سريعة.
**الطابور والتحكم بمعدل الإرسال (Queueing & throttling):** قم بتخزين الطلبات الصادرة مؤقتًا أو وضعها في طابور من جانبك للتحكم في تدفق حركة المرور قبل إعادة إرسالها.
**التراجع الأسي مع التذبذب العشوائي (Exponential backoff with jitter):** عند إعادة المحاولة، قم بزيادة وقت الانتظار بشكل أسي بين المحاولات (مثال: 1 ثانية، 2 ثانية، 4 ثوانٍ، 8 ثوانٍ) وأضف تأخيرًا عشوائيًا صغيرًا ("jitter") لمنع تأثير القطيع حيث تعيد جميع الطلبات المنت ظرة المحاولة في نفس الميلي ثانية بالضبط.

تحذيرالاستمرار في إرسال الطلبات إلى نقطة نهاية محدودة المعدل دون تراجع يمكن أن **يُطيل فترة التقييد** ويؤثر بشكل كبير على معدل النقل التشغيلي لنظامك. التحكم السليم في معدل الطلبات من جانبك يضمن تكاملاً أكثر سلاسة ومرونة.
للاطلاع على الحدود الافتراضية وزيادة الطلبات والتفاصيل الإضافية، راجع [حدود المعدل](/ar/developers/start/rate-limits).الرمزالرسالةالوصف`99999`Internal failure! Try again laterعند حدوث خطأ داخلي.
### الخطوات التالية​

عُد إلى [إنشاء عملية](/ar/human-token/api-reference/post-processes) لإرسال صورة شخصية جديدة.
لفهم ما يمثّله `humanToken` ومتى لا يُولَّد، راجع [نظرة عامة على Human Token](/ar/human-token/).
آخر تحديث في 22 أكتوبر 2026**