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

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

متاحة فقط للعمليات التي نفَّذت التقاطًا بيومتريًا (أي تدفق يتضمن اختبار الحيوية أو التحقق من الهوية). غير متاحة لتدفقات إعادة التحقق الذكي (idsmart).

نقطة النهاية

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

الطلب

الترويسات

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

الاستجابات

200 OK

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

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

400 Bad Request

المعامل processId في المسار مفقود أو غير صحيح.

401 Unauthorized

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

403 Forbidden

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

404 Not Found

لم يُعثر على العملية، أو الصورة الشخصية غير متاحة لهذه العملية (مثلاً تدفق إعادة التحقق الذكي).

رموز الخطأ

ملاحظة

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

400 Bad Request

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

401 Unauthorized

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

403 Forbidden

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

404 Not Found

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

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

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