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

MarkdownChatGPTClaude

تُعيد الصورة الشخصية البيومترية الملتقَطة من المستخدم خلال الرحلة المستضافة من 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.

رموز الخطأ

ملاحظة

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

400 Bad Request

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

401 Unauthorized

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

403 Forbidden

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

404 Not Found

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

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

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