Get SelfieGET

استرجاع الصورة الشخصية الملتقطة خلال عملية Human Token.

Markdown

تُعيد صورة السيلفي البيومترية التي التقطها المستخدم أثناء عملية Human Token. تُعاد الصورة كسلسلة نصية مشفّرة بترميز base64.

متاحة لأي عملية منتهية نفّذت التقاطًا بيومتريًا — جميع تدفقات Human Token الخمسة (api+humantoken، api+liveness+humantoken، api+liveness+humantoken+revalidation، humantoken، humantoken+revalidation). غير متاحة عندما تنتهي العملية دون التقاط بيومتري، حيث لا توجد سيلفي لإعادتها.

تحذير

الصورة الشخصية متاحة لمدة 24 ساعة بعد انتهاء العملية. بعد ذلك، يتم حذف الصورة نهائيًا ويُرجع هذا المسار 404.

نقطة النهاية

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

الطلب

Headers

Header	القيمة
x-unico-accesskey	<your_access_key> (راجع المصادقة)

معاملات المسار (Path)

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

مثال

cURL

curl -X GET https://humantoken.unico.app/client/v1/process/$PROCESS_ID/selfie \
  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://humantoken.unico.app/client/v1/process/${processId}/selfie`,
  { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } }
);
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

مفتاح الوصول مفقود أو غير صالح في الترويسة x-unico-accesskey. راجع المصادقة.

403 Forbidden

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

404 Not Found

العملية غير موجودة، أو انتهت العملية دون التقاط صورة بيومترية، أو انتهت فترة الاحتفاظ البالغة 24 ساعة.

429 Too Many Requests

Rate limit reached. When your system receives an HTTP 429 error, you must implement mechanisms to prevent cascading failures and avoid worsening the restriction.

Best practices:

• Cool-down period (backoff): Immediately halt or throttle subsequent requests from your system. Do not continuously retry failed requests in a tight loop.
• Queueing & throttling: Buffer or queue outgoing requests on your end to control the traffic flow before re-sending them.
• Exponential backoff with jitter: When retrying, increase the waiting time exponentially between attempts (e.g., 1 s, 2 s, 4 s, 8 s) and add a small random delay ("jitter") to prevent a herd effect where all queued requests retry at the exact same millisecond.

تحذير

Continuously hitting a rate-limited endpoint without backing off can prolong the restriction period and severely impact your system's operational throughput. Properly throttling requests on your side ensures a smoother, more resilient integration.

For default limits, increase requests and additional details, see Rate Limits.

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

• للحصول على نتيجة العملية الكاملة، راجع الحصول على العملية.
• عُد إلى إنشاء عملية لإرسال سيلفي جديدة.