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

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

Markdown

GET /v1/processes/{id}

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

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 معلّق:

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

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

تعيد العملية المنتهية نتيجتها في data: هوية الشخص في humanToken، والمعلومات الاستخباراتية عن الشخص في ndocs، إضافة إلى liveness عندما يفحصه المسار. وتعيد إعادة التحقق humanTokenMatch بدلاً من humanToken. يُشرح كل حقل في النتيجة في data. وتعيد العملية الفاشلة PROCESS_STATE_FAILED مع data فارغة.

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

{
  "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 الشخص الذي أكدتَ هويته:

{
  "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 }
      ]
    }
  }
}

عملية فاشلة:

{ "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	فشلت قاعدة البيانات. أعد المحاولة لاحقاً

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

التالي

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