الحصول على مجموعة الأدلة

MarkdownChatGPTClaude

تُعيد حزمة الأدلة التي تم إنشاؤها أثناء الالتقاط البيومتري — وهي حزمة تحتوي على الصور المُلتقَطة والبيانات الوصفية وقطع أدلة الالتقاط المستخدَمة لإثبات أن كشف لايفنس نُفِّذ ضمن ظروف مُتحكَّم بها.

متاحة فقط للعمليات المكتملة (state = PROCESS_STATE_FINISHED).

النقطة النهائية

البيئة	الرابط
الإنتاج	GET https://api.idcloud.unico.app/client/v1/process/{processId}/evidenceset
Sandbox	GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/evidenceset

الطلب

Headers

Header	القيمة
Authorization	Bearer <access_token> (راجع المصادقة)

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

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

مثال

cURL

curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
  -H "Authorization: Bearer $TOKEN"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
  { headers: { Authorization: `Bearer ${accessToken}` } }
);
const { fileContents, contentType } = await res.json();
// fileContents هي حزمة PDF مُرمَّزة بـ base64

الاستجابات

200 OK

{
  "fileContents": "JVBERi0xLjMNCi...",
  "contentType": "application/pdf"
}

الحقل	النوع	الوصف
fileContents	string (base64)	حزمة الأدلة، مُرمَّزة بـ base64.
contentType	string	نوع MIME — عادةً application/pdf.

رموز الأخطاء

ملاحظة

لا تعرض API قيم code أو message محددة لهذه النقطة النهائية.

400 Bad Request

معامل المسار processId مفقود أو مُشوَّه.

401 Unauthorized

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

404 Not Found

لم يتم العثور على العملية، أو مجموعة الأدلة غير متاحة بعد (العملية لم تنتهِ).

500 Internal Server Error

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

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

• للحصول على نتيجة العملية الكاملة، راجع الحصول على العملية.
• للحصول على الصورة الشخصية الملتقطة، راجع الحصول على الصورة الشخصية.