الحصول على الصورة الشخصية

MarkdownChatGPTClaude

تُعيد الصورة الشخصية البيومترية التي التقطها المستخدم خلال الرحلة المُستضافة من Unico. تُعاد الصورة كسلسلة نصية مُرمَّزة بـ base64 مع علامة مائية مُطبَّقة.

متاحة لأي عملية منتهية نفّذت التقاطًا بيومتريًا، بما في ذلك رحلات إعادة التحقق الذكية (idsmart). غير متاحة عندما تنتهي العملية بدون التقاط بيومتري (مصادقة صامتة، على سبيل المثال)، لأنه لا توجد صورة شخصية لإعادتها.

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

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

الطلب

Headers

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

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

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

مثال

cURL

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

Node.js

import fetch from 'node-fetch';

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

الاستجابات

200 OK

{
  "fileContents": "/9j/4AAQSkZJR...",
  "contentType": "image/jpeg"
}

الحقل	النوع	الوصف
fileContents	string (base64)	الصورة الشخصية المُلتقَطة، مُرمَّزة بـ base64. تحتوي على علامة مائية.
contentType	string	نوع MIME للصورة — image/jpeg أو image/png.

رموز الأخطاء

ملاحظة

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

400 Bad Request

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

401 Unauthorized

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

403 Forbidden

أذونات غير كافية للوصول إلى الصورة الشخصية لهذه العملية.

404 Not Found

لم يتم العثور على العملية، أو انتهت العملية بدون التقاط بيومتري، لذا لا توجد صورة شخصية لإعادتها.

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

• للحصول على نتيجة العملية الكاملة، راجع الحصول على العملية.
• للحصول على حزمة تدقيق الأدلة، راجع الحصول على مجموعة الأدلة.