---
title: الحصول على عملية
description: GET /v1/processes/{id} — قراءة عملية ونتيجتها، وHuman Token، والمعلومات الاستخباراتية عن الشخص.
canonical: https://developer.unico.io/ar/human-plugin/api-reference/get-process
locale: ar
generated_by: markdown-export
---

# الحصول على عملية

اقرأ عملية بالمعرّف الذي أعاده Human Plugin عند الإنشاء.

`GET /v1/processes/{id}`

`id` هو UUID الوارد في استجابة الإنشاء. لا توجد ترويسة مصادقة ولا تقييد بحسب العميل: أي جهة استدعاء تستطيع الوصول إلى Human Plugin يمكنها قراءة أي من عملياته.

```bash
curl http://human-plugin.internal:8080/v1/processes/b063041c-7529-4e70-a2b4-c71c00f19801
```

## متى تصل النتيجة

- تُفحص العملية **المعلّقة** (`PROCESS_STATE_CREATED`) عند كل قراءة، ويُرد عليها بنتيجتها بمجرد توفرها.
- العملية **المنتهية** أو **الفاشلة** نهائية، ويُرد عليها كما هي.
- يُرد على عملية إنشاء انقطعت بوصفها فاشلة بعد نحو 70 ثانية من بدايتها.

القراءة هي السبيل الوحيد لتقدّم العملية المعلّقة: لا توجد مهمة في الخلفية، والعودة إلى `callbackUri` الخاص بك لا تحدّث Human Plugin.

## الاستجابة

`200 OK` بنفس بنية الإنشاء: `id` و`state` و`data`.

Journey معلّق:

```json
{ "id": "b063041c-7529-4e70-a2b4-c71c00f19801", "state": "PROCESS_STATE_CREATED", "data": {} }
```

<a id="finished-and-failed-processes"></a>

### العمليات المنتهية والفاشلة

تعيد العملية المنتهية نتيجتها في `data`: هوية الشخص في `humanToken`، و[المعلومات الاستخباراتية](/ar/human-plugin/get-started/intelligence) عن الشخص في `ndocs`، إضافة إلى `liveness` عندما يفحصه المسار. وتعيد إعادة التحقق `humanTokenMatch` بدلاً من `humanToken`. يُشرح كل حقل في [النتيجة في `data`](/ar/human-plugin/api-reference/create-process#result). وتعيد العملية الفاشلة `PROCESS_STATE_FAILED` مع `data` فارغة.

عملية منتهية:

```json
{
  "id": "b063041c-7529-4e70-a2b4-c71c00f19801",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanToken": { "value": "6d3d71…", "status": "validated" },
    "liveness": { "value": "live", "status": "validated" },
    "ndocs": {
      "distinctClientsCount": 2,
      "transactionsCount": 3,
      "firstSeen": "2026-09-08",
      "lastSeen": "2026-11-03",
      "credentials": [
        { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
      ]
    }
  }
}
```

إعادة تحقق منتهية، حيث يصف `ndocs` الشخص الذي أكدتَ هويته:

```json
{
  "id": "7f2c9a10-3d4e-4b5f-8a61-0c9e2d7b4a35",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanTokenMatch": "true",
    "liveness": { "value": "live", "status": "validated" },
    "ndocs": {
      "distinctClientsCount": 2,
      "transactionsCount": 4,
      "firstSeen": "2026-09-08",
      "lastSeen": "2026-11-04",
      "credentials": [
        { "type": "DUI_TYPE_NG_BVN", "countryCode": "NGA", "distinctCredentialCount": 1 }
      ]
    }
  }
}
```

عملية فاشلة:

```json
{ "id": "c41e8b27-95d0-4a8f-b3e6-2f7a1d9c0e58", "state": "PROCESS_STATE_FAILED", "data": {} }
```

لا يُعاد `token` و`link` الخاصان بـ Journey إلا عند الإنشاء. احتفظ بهما من تلك الاستجابة.

## الأخطاء

| الحالة | `message` | المعنى |
| --- | --- | --- |
| 404 | `PROCESS_NOT_FOUND` | المعرّف ليس UUID أو غير معروف |
| 502 | `UPSTREAM_UNAVAILABLE` | العملية معلّقة وتعذّر فحص نتيجتها. أعد المحاولة لاحقاً |
| 503 | `DATABASE_UNAVAILABLE` | فشلت قاعدة البيانات. أعد المحاولة لاحقاً |

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

## التالي

[الحصول على صورة السيلفي](/ar/human-plugin/api-reference/get-selfie)