الحصول على العملية

تحذير

قبل استرداد العملية، راجع إعداد webhook والاستراتيجيات الاحتياطية — انقر هنا.

في عقد API، تُعدّ استجابة POST /processes/v1 بالفعل النتيجة النهائية. توجد هذه النقطة النهائية لإعادة الاستعلام — على سبيل المثال، عندما تحتاج إلى فحص عملية حفظتها مسبقاً، أو مراجعة معاملة سابقة.

نقطة النهاية

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

الطلب

الترويسات

الترويسة	القيمة
Authorization	Bearer <access_token>
APIKEY	مفتاح API المُخصص.

معاملات المسار

المعامل	النوع	مطلوب	الوصف
processId	string (UUID)	نعم	معرّف العملية الذي يُعيده إنشاء عملية.

مثال

cURL

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

Node.js

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

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": { "result": "yes" },
  "identityFraudsters": { "result": "inconclusive" },
  "government": { "serpro": 87 },
  "liveness": 1
}

الحقل	النوع	الوصف
id	string (UUID)	معرّف العملية.
status	integer	1 (قيد المعالجة)، 2 (تباين)، 3 (اكتمل بنجاح)، 4 (ملغى)، 5 (خطأ).
unicoId.result	string	yes، no، inconclusive — راجع التحقق من الهوية.
identityFraudsters.result	string	yes، inconclusive — راجع تصنيف المخاطر.
government.serpro	integer	درجة التشابه في Serpro (0–100، -1، -2). راجع تشابه Serpro.
liveness	integer	1 (اجتاز)، 2 (فشل) — راجع Liveness.
score	integer	درجة المخاطرة الاحتمالية. موجود عندما unicoId.result = inconclusive وتكون تنسيق درجة المخاطرة نشطاً. القيم الإيجابية تشير إلى احتمالية أعلى لكونه الحامل الأصلي؛ القيم السلبية تشير إلى مخاطرة أعلى.

400 Bad Request

معامل المسار processId مفقود أو غير صحيح. انظر رموز الخطأ أدناه.

403 Forbidden

رمز Bearer أو APIKEY مفقود أو منتهي الصلاحية أو غير صالح.

404 Not Found

processId غير موجود أو لا ينتمي إلى المستأجر المصادَق عليه.

410 Gone

العملية موجودة لكنها انتهت بخطأ. تُعيد فقط id وstatus: 5.

429 Too Many Requests

تم الوصول إلى حد المعدل. انظر حدود المعدل.

500 Internal Server Error

خطأ غير متوقع في الخادم.

متى تستخدم هذه النقطة النهائية

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

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

رموز الخطأ

400 Bad Request

الرمز	الرسالة	الوصف
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.	معامل رمز التكامل مفقود من ترويسة الطلب.

404 Not Found

الرمز	الرسالة	الوصف
50001	O processo informado não foi encontrado.	العملية غير موجودة في قاعدة البيانات.

403 Forbidden

الرمز	الرسالة	الوصف
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 أو غير موجود.

410 Gone

العملية موجودة لكنها أسفرت عن خطأ. تُعيد فقط id و status: 5.

500 Internal Server Error

الرمز	الرسالة	الوصف
99999	Internal failure! Try again later	عند وجود خطأ داخلي.