Process प्राप्त करेंGET

create पर Human Plugin द्वारा लौटाई गई id से कोई process पढ़ें।

Markdown

GET /v1/processes/{id}

id create के जवाब का UUID है। कोई authentication header नहीं है और कोई client scoping भी नहीं: जो भी caller Human Plugin तक पहुँच सकता है, वह उसकी किसी भी process को पढ़ सकता है।

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

नतीजा कब मिलता है

• pending process (PROCESS_STATE_CREATED) की हर read पर जाँच होती है, और नतीजा मिलते ही उसी के साथ जवाब दिया जाता है।
• finished या failed process अंतिम होती है, और जैसी है वैसी ही लौटाई जाती है।
• बीच में रुके create को शुरू होने के लगभग 70 सेकंड बाद failed के रूप में लौटाया जाता है।

Read ही वह एकमात्र तरीक़ा है जिससे pending process आगे बढ़ती है: कोई background job नहीं है, और आपके callbackUri पर वापसी Human Plugin को update नहीं करती।

Response

200 OK, create जैसी ही संरचना के साथ: id, state और data।

एक pending Journey:

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

Finished और failed processes

finished process अपना नतीजा data में लौटाती है: व्यक्ति कौन है, humanToken में, और व्यक्ति की intelligence, ndocs में, साथ ही liveness जब flow उसे जाँचता है। पुनर्सत्यापन humanToken की जगह humanTokenMatch लौटाता है। हर field का वर्णन data में नतीजा में है। failed process खाली data के साथ PROCESS_STATE_FAILED लौटाती है।

एक finished process:

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

एक finished पुनर्सत्यापन, जहाँ 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 }
      ]
    }
  }
}

एक failed process:

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

Journey का token और link केवल create में लौटाए जाते हैं। उन्हें उसी response से सहेजकर रखें।

Errors

Status	message	अर्थ
404	PROCESS_NOT_FOUND	id UUID नहीं है या अज्ञात है
502	UPSTREAM_UNAVAILABLE	process pending है और उसका नतीजा जाँचा नहीं जा सका। बाद में फिर कोशिश करें
503	DATABASE_UNAVAILABLE	database विफल हुआ। बाद में फिर कोशिश करें

Reads को retry करना सुरक्षित है।

आगे

Selfie प्राप्त करें