الحصول على صورة السيلفيGET

اقرأ صورة السيلفي الملتقطة لعملية، بالمعرّف الذي أعاده Human Plugin عند الإنشاء.

Markdown

GET /v1/processes/{id}/selfie

id هو UUID الوارد في استجابة الإنشاء. الطلب بلا جسم ولا معاملات استعلام.

curl http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie

لا يحتفظ Human Plugin بنسخة من صورة السيلفي: كل استدعاء يجلبها من جديد.

الاستجابة

200 OK، مع الصورة بصيغة base64 ونوعها:

{
  "fileContents": "/9j/4AAQSkZJRgABAQAAAQABAAD…",
  "contentType": "image/jpeg"
}

لحفظها كملف:

curl -s http://human-plugin.internal:8080/v1/processes/17e4546e-6109-4240-8c0b-4ba98474a104/selfie \
  | jq -r .fileContents | base64 -d > selfie.jpg

التوفر

• توجد صورة سيلفي فقط للعملية التي كانت لها صورة: أُرسلت في imageBase64 أو التُقطت من الشخص.
• مع مسار Journey، لا توجد الصورة إلا بعد أن يلتقطها الشخص. وإلى ذلك الحين يُرفض الطلب بالرمز 400 مع message يبدأ بـ process state must be finished. اقرأ العملية أولاً، واحصل على الصورة حين تصبح PROCESS_STATE_FINISHED.
• تتوفر صورة السيلفي لفترة محدودة بعد انتهاء العملية. إذا احتجتها لاحقاً، فاحفظها من هذه الاستجابة.

التعامل مع الصورة

صورة السيلفي بيانات بيومترية. لا يخزّنها Human Plugin ولا يسجّلها في السجلات أبداً، وتُرسل الاستجابة مع Cache-Control: no-store. أبقِها خارج سجلات البوابة والتطبيق لديك أيضاً.

الأخطاء

الحالة	message	المعنى
400	process state must be finished…	عملية Journey لم ينتهِ التقاطها بعد. اقرأ العملية أولاً
404	PROCESS_NOT_FOUND	المعرّف ليس UUID أو غير معروف
404	SELFIE_NOT_FOUND	لا توجد صورة سيلفي للعملية: لم يكن لها التقاط، أو فشلت قبل أن تبدأ، أو لم تعد الصورة متاحة
4xx	message الرفض	رُفض الطلب. السبب في message وdetails
502	UPSTREAM_UNAVAILABLE	تعذّر جلب الصورة في الوقت المحدد. أعد المحاولة لاحقاً
503	DATABASE_UNAVAILABLE	فشلت قاعدة البيانات. أعد المحاولة لاحقاً

القراءات آمنة لإعادة المحاولة. ولا يتغير الرمز 404 عند إعادة المحاولة.

التالي

دورة حياة العملية