الحصول على مجموعة الأدلة
تُعيد حزمة الأدلة التي تم إنشاؤها أثناء الالتقاط البيومتري — وهي حزمة تحتوي على الصور المُلتقَطة والبيانات الوصفية وقطع أدلة الالتقاط المستخدَمة لإثبات أن كشف لايفنس نُفِّذ ضمن ظروف مُتحكَّم بها.
متاحة فقط للعمليات المكتملة (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
- Node.js
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/evidenceset \
-H "Authorization: Bearer $TOKEN" \
| jq -r .fileContents | base64 --decode > evidence-set.pdf
import { writeFile } from 'node:fs/promises';
async function getEvidenceSet(processId) {
const response = await fetch(
`https://api.idcloud.unico.app/client/v1/process/${processId}/evidenceset`,
{ headers: { Authorization: `Bearer ${accessToken}` } }
);
if (!response.ok) throw new Error(`Get Evidence Set failed with ${response.status}`);
const { fileContents } = await response.json();
// fileContents هو ملف PDF، مُرمَّز بـ base64
return Buffer.from(fileContents, 'base64');
}
// احفظ ملف PDF على القرص
await writeFile(`evidence-set-${processId}.pdf`, await getEvidenceSet(processId));
// أو أرسله إلى المتصفح (Express)
app.get('/processes/:id/evidence-set', async (req, res) => {
const pdf = await getEvidenceSet(req.params.id);
res
.type('application/pdf') // لا تُمرِّر contentType: تُعيد API القيمة "x-pdf"
.set('Content-Disposition', 'inline; filename="evidence-set.pdf"')
.send(pdf);
});
الاستجابات
200 OK
{
"fileContents": "JVBERi0xLjMNCi...",
"contentType": "x-pdf"
}
| الحقل | النوع | الوصف |
|---|---|---|
fileContents | string (base64) | ملف PDF الخاص بمجموعة الأدلة، مُرمَّز بـ base64. |
contentType | string | حاليًا تُعيد القيمة x-pdf. |
بناء ملف PDF
x-pdf ليس نوع MIME صالحًا، والمتصفحات لا تتعرف عليه. لا تُمرِّر contentType إلى المتصفح. فُك تشفير fileContents من base64 وقدِّم البايتات كـ application/pdf، كما في مثال Node.js أعلاه.
رموز الأخطاء
ملاحظة
لا تعرض API قيم code أو message محددة لهذه النقطة النهائية.
- 400 Bad Request
- 401 Unauthorized
- 404 Not Found
- 500 Internal Server Error
معامل المسار processId مفقود أو مُشوَّه.
رمز Bearer مفقود، منتهي الصلاحية، أو غير صالح. راجع المصادقة.
لم يتم العثور على العملية، أو مجموعة الأدلة غير متاحة بعد (العملية لم تنتهِ).
| الرمز | الرسالة | الوصف |
|---|---|---|
99999 | Internal failure! Try again later | عندما يحدث خطأ داخلي. |
الخطوات التالية
- للحصول على نتيجة العملية الكاملة، راجع الحصول على العملية.
- للحصول على الصورة الشخصية الملتقطة، راجع الحصول على الصورة الشخصية.