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

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

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

نقطة النهاية

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

الطلب

الترويسات

الترويسة	القيمة
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 is a base64-encoded PDF bundle

الاستجابات

200 OK

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

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

400 Bad Request

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

401 Unauthorized

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

404 Not Found

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

رموز الأخطاء

ملاحظة

لا تكشف واجهة API عن قيم code أو message محددة لهذه النقطة.

400 Bad Request

لا توجد قيم code أو message موثقة لهذه الحالة.

401 Unauthorized

لا توجد قيم code أو message موثقة لهذه الحالة.

404 Not Found

لا توجد قيم code أو message موثقة لهذه الحالة.

500 Internal Server Error

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

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

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