---
title: الحصول على العملية
description: استرداد عملية تعاقد API موجودة بواسطة معرّفها. يُستخدم لإعادة الاستعلام حيث يتم إرجاع النتائج بشكل متزامن عند الإنشاء.
canonical: https://developer.unico.io/ar/dual-api/developers/api-reference/api/get-process
locale: ar
generated_by: markdown-export
---

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

**في هذه الصفحةالحصول على العمليةGETاسترداد عملية موجودة بواسطة معرّفها. وفقاً لتعاقد API، يتم بالفعل إرجاع النتيجة بشكل متزامن عند إنشاء العملية — استخدم نقطة النهاية هذه لإعادة الاستعلام والتدقيق والدعم.

تحذيرقبل استرداد العملية، راجع إعداد webhook والاستراتيجيات الاحتياطية — [انقر هنا](/ar/developers/webhooks-and-events/setup).
### نقطة النهاية​

البيئةالرابط**الإنتاج**`GET https://api.id.unico.app/processes/v1/{processId}`**Sandbox**`GET https://api.id.uat.unico.app/processes/v1/{processId}`
### الطلب​

الترويسات
الترويسةالقيمة`Authorization``Bearer <access_token>``APIKEY`مفتاح API المخصص.
معاملات المسار
المعاملالنوعمطلوبالوصف`processId`string (UUID)نعممعرّف العملية الذي تم إرجاعه بواسطة [إنشاء عملية](/ar/dual-api/developers/api-reference/api/post-processes).
### مثال​

cURLNode.js```
curl -X GET https://api.id.unico.app/processes/v1/$PROCESS_ID \  -H "Authorization: Bearer $TOKEN" \  -H "APIKEY: $API_KEY"
```

```
import fetch from 'node-fetch';const res = await fetch(  `https://api.id.unico.app/processes/v1/${processId}`,  {    headers: {      Authorization: `Bearer ${accessToken}`,      APIKEY: apiKey    }  });const result = await res.json();
```

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

200 OK
التعاقد فريد — يحمل الحقل `idCloud.result` الحكم الموحّ د للإمكانيات المستخدمة.
توحّد Unico نتائج الإمكانيات المنفّذة في `idCloud.result` واحد، جاهز لتحديد الخطوة التالية في تدفقك — دون الحاجة إلى تنسيق النتائج الفردية.
```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 3,  "idCloud": {    "result": "approved"  }}
```

الحقلالنوعالوصف`id`string (UUID)معرّف العملية.`status`integer`1` (قيد المعالجة)، `2` (تباين)، `3` (انتهت بنجاح)، `4` (ملغاة)، `5` (خطأ).
قيم النتيجة المحتملة
idCloud.resultالمعنىالإجراء الموصى بهapprovedشخص حقيقي وهوية تم التحقق منها.تابع التدفق.deniedلم يتم التحقق من الهوية، فشل فحص لايفنس، أو تم تحديد مخاطر شديدة.أنهِ التدفق أو أعد التوجيه إلى تدفق بديل.critical-riskتم تحديد مستوى مخاطر حرج.أنهِ التدفق أو وجّهه إلى مراجعة يدو ية.high-riskتم تحديد مستوى مخاطر مرتفع.وجّه إلى مراجعة يدوية أو تدفق بديل.retryالتقاط أو درجة غير كافية للتقييم.اطلب من المستخدم التقاطاً جديداً.inconclusiveلا يوجد دليل كافٍ لإصدار حكم.وجّه إلى مراجعة يدوية أو تدفق بديل.
تعتمد القيم المُرجعة على الوصفة المكوّنة في APIKey الخاص بك. انظر [التدفقات](/ar/dual-api/developers/api-reference/api/flows) لمعرفة قيم النتيجة التي يمكن أن ترجعها كل وصفة.
قد يتلقى العملاء في البرازيل الاستجابة حسب الإمكانيةيظل الهيكل العام للاستجابة كما هو — النتيجة الواحدة هي الافتراضية.قد تتلقى عمليات التكامل في البرازيل النتائج المفتوحة لكل إمكانية على حدة. تضيف كل إمكانية مفعّلة في APIKey كتلتها الخاصة إلى الاستجابة — يتم حذف الحقول الخاصة بالإمكانيات غير المفعّلة.```
{  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",  "status": 3,  "unicoId": {    "result": "yes"  },  "riskLevel": {    "result": "inconclusive"  },  "idFace": {    "personId": "a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890",    "result": "FOUND"  },  "identityFraudsters": {    "result": "inconclusive"  },  "government": {    "serpro": 87  },  "liveness": 1,  "idAge": {    "result": "yes"  },  "cardholderVerification": {    "result": "approved"  }}
```

الحقلالنوعالوصف`unicoId.result`string`yes`، `no`، `inconclusive` — انظر [التحقق من الهوية](/ar/capabilities/identity-verification).`riskLevel.result`string`not_approved`، `critical_risk`، `high_risk`، `inconclusive` — انظر [تصنيف مخاطر الاحتيال](/ar/capabilities/fraud-risk-classification).`idFace.result`string`FOUND` — انظر معرّف الوجه.`idFace.personId`stringمعرّف مستقر وغير شفاف للوجه، يُعاد جنبًا إلى جنب مع `idFace.result = FOUND`. عندما يتعذّر التعرف على أي وجه في الصورة، تُعيد العملية الخطأ `20532` بدلاً من كت لة `idFace`.`identityFraudsters.result`string**مهجور.** استخدم `riskLevel` بدلاً منه. يمكن للعملاء الذين لديهم عمليات تكامل جارية الاستمرار في استخدامه أثناء تنسيق الترحيل مع فريق مشروعهم.`government.serpro`integerدرجة تشابه Serpro (0–100، ‎-1‎، ‎-2‎). متاح في البرازيل فقط. انظر [عائد تشابه Serpro](/ar/capabilities/serpro-similarity-return).`liveness`integer`1` (نجح)، `2` (فشل) — انظر [لايفنس](/ar/capabilities/liveness).`idAge.result`string`yes`، `no`، `inconclusive` — انظر [التحقق من العمر](/ar/capabilities/age-verification). متاح في البرازيل فقط.`score`integerدرجة مخاطر احتمالية. موجودة عندما تكون `unicoId.result = inconclusive` وتنسيق درجة المخاطر نشط. القيم الموجبة تشير إلى احتمالية أعلى لكون الشخص هو صاحب الحساب؛ القيم السالبة تشير إلى مخاطر أعلى. متاح في البرازيل فقط.`cardholderVerification.result`string`approved`، `unsure` — انظر [Cardholder Verification](/ar/capabilities/cardholder-verification). غائب أثناء عدم بلوغ `status` قيمة `3` (منتهية) بعد. متاح في البرازيل فقط.
قد يتلقى العملاء في المكسيك كتلة التحقق من RENAPOتحتفظ الاستجابة بالهيكل نفسه وتضيف كتلة idGov.تتلقى عمليات التكامل في المكسيك التي فُعّل فيها التحقق من RENAPO كتلة idGov إضافية تتضمن السجل الذي تحتفظ به RENAPO لـ CURP الخاص بالمستخدم. وهي إجابة منفصلة عن نتيجة الهوية.```
{  "id": "11111111-2222-3333-4444-555555555555",  "status": 3,  "idCloud": { "result": "approved" },  "idGov": {    "government_valid": true,    "curp": "PUEA880304MDFRJN04",    "government_name": "ANA PRUEBA EJEMPLO",    "date_of_birth": "1988-03-04",    "age": 38,    "gender": "F",    "deceased": false,    "is_mexican": true,    "citizenship": "MEXICO",    "state_of_birth": "Ciudad de México",    "state_iso": "MX-CMX",    "issuing_entity_code": "DF",    "municipality_registration": ""  }}
```

الحقلالنوعالوصف`idGov`objectسجل RENAPO لـ CURP. غائب عندما لا تكون القدرة مفعّلة. `{}` عندما لا تستجيب RENAPO. المكسيك فقط. انظر [التحقق من RENAPO](/ar/capabilities/renapo-verification).
### متى تستخدم نقطة النهاية هذه​

تعاقد API يُرجع النتائج بشكل متزامن، لذا معظم عمليات التكامل لا تحتاج إلى نقطة النهاية هذه. استخدمها عندما:

حفظت فقط `processId` وتحتاج إلى استرداد النتيجة الكاملة لاحقاً (تدقيق، دعم).
تشك في أن الاستجابة الأصلية فُقدت أثناء النقل (خطأ في الشبكة بعد أن أكملت المنصة العمل).
تقوم ببناء أداة مكتب خلفي تراجع العمليات التاريخية.

### رموز الخطأ​

400 Bad Request404 Not Found403 Forbidden410 Gone429 Too Many Requests500 Internal Server Errorالرمزالرسالةالوصف`20023`O parâmetro processId não foi informado.معامل معرّف العملية مفقود.`20002`O parâmetro APIKey não foi informado.معامل APIKEY مفقود من ترويسة الطلب.`20001`O parâmetro authtoken não foi informado.معامل رمز التكامل مفقود من ترويسة الطلب.الرمزالرسالةالوصف`50001`O processo informado não foi encontrado.العملية غير موجودة في قاعدة البيانات.الرمزالرسالةالوصف`30017`User does not have permission to perform this action.JWT غير صحيح أو مستخدم بدون صلاحية لتنفيذ هذه العملية.`10502`O token informado está expirado.عندما تكون صلاحية رمز الوصول المستخدم قد انتهت.`10501`O token informado é inválido.رمز المصادقة المُقدَّم غير صالح.`10201`O AppKey informado é inválido.معامل APIKEY غير صالح أو غير موجود.العملية موجودة لكنها أسفرت عن خطأ. تُرجع فقط `id` و`status: 5`.تم الوصول إلى حد المعدل. عندما يتلقى نظامك خطأ HTTP 429، يجب عليك تطبيق آليات لمنع حالات الفشل المتتالية وتجنب تفاقم القيود.
**أفضل الممارسات:**

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

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

الوصفة هي مجموعة الإمكانيات (لايفنس، التحقق من الهوية، إشارات المخاطر، المستندات...) المكوّنة في APIKey الخاص بمشروعك. تحدد ما تنفذه Unico في كل عملية وكيف يتم توحيد النتائج في `result` واحد — لا تحتاج إلى تنسيق أي شيء من جانبك.
تحتفظ Unico بكتالوج من الوصفات المُعدّة مسبقاً، المسماة والمرقمة بالإصدار (مثلاً `byunico-idlive-idunico-oneresponse-std`). بعضها حصري للبرازيل، مثل تلك التي تتضمن Score أو Serpro أو التحقق من العمر.
ما هي الإمكانيات التي تُشغّل عمليتك؟مجموعة الإمكانيات — تدفق مشروعك — مُحددة في إعدادات APIKey الخاص بك. راجع الوصفات المُعدّة مسبقاً أو تواصل مع مسؤول مشروع Unico لتخصيصها.آخر تحديث في 8 أكتوبر 2026**