---
title: الحصول على صورة السيلفي
description: GET /v1/processes/{id}/selfie — قراءة صورة السيلفي الملتقطة لعملية، ومدة توفرها، والأخطاء.
canonical: https://developer.unico.io/ar/human-plugin/api-reference/get-selfie
locale: ar
generated_by: markdown-export
---

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

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

`GET /v1/processes/{id}/selfie`

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

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

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

## الاستجابة

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

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

لحفظها كملف:

```bash
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`. [اقرأ العملية](/ar/human-plugin/api-reference/get-process) أولاً، واحصل على الصورة حين تصبح `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` عند إعادة المحاولة.

## التالي

[دورة حياة العملية](/ar/human-plugin/api-reference/process-lifecycle)