प्रोसेस प्राप्त करेंGET

किसी Human Token प्रोसेस को उसके आइडेंटिफ़ायर द्वारा प्राप्त करें — यूज़र के Human Token Journey से लौटने के बाद, या किसी API Only परिणाम को दोबारा क्वेरी करने के लिए।

Markdown

Endpoint

एनवायरनमेंट	URL
प्रोडक्शन	GET https://humantoken.unico.app/client/v1/process/{processId}

रिक्वेस्ट

हेडर

Header	मान
x-unico-accesskey	<your_access_key> (देखें ऑथेंटिकेशन)

पाथ पैरामीटर

पैरामीटर	प्रकार	आवश्यक	विवरण
processId	string (UUID)	हाँ	प्रोसेस बनाएं द्वारा लौटाया गया प्रोसेस आइडेंटिफ़ायर।

उदाहरण

cURL

curl -X GET https://humantoken.unico.app/client/v1/process/$PROCESS_ID \
  -H "x-unico-accesskey: $UNICO_ACCESS_KEY"

Node.js

import fetch from 'node-fetch';

const res = await fetch(
  `https://humantoken.unico.app/client/v1/process/${processId}`,
  { headers: { 'x-unico-accesskey': process.env.UNICO_ACCESS_KEY } }
);
const result = await res.json();
// result.data.humanToken.value

रिस्पॉन्स

200 OK

रिस्पॉन्स का फ़ॉर्मेट प्रोसेस बनाएं जैसा ही है। data का स्वरूप प्रोसेस बनाते समय उपयोग किए गए फ़्लो पर निर्भर करता है।

स्टैंडर्ड फ़्लो (api+humantoken, api+liveness+humantoken, humantoken):

{
  "id": "6ed74799-4c2f-4023-b43f-a73cf7c847b2",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanToken": {
      "value": "3f9a1c7e5b2d4086a1e3c5f7092b4d6e8a0c2e4f6183a5c7e9b1d3f5072a4c6e",
      "status": "validated"
    }
  }
}

रीवैलिडेशन फ़्लो (api+liveness+humantoken+revalidation, humantoken+revalidation):

{
  "id": "cb0472c0-6dbc-46c6-b830-2be7edc35424",
  "state": "PROCESS_STATE_FINISHED",
  "data": {
    "humanTokenMatch": "true"
  }
}

फ़ील्ड	प्रकार	विवरण
id	string (UUID)	प्रोसेस आइडेंटिफ़ायर।
state	string	प्रोसेस की स्थिति — देखें state के मान।
data.​humanToken.​value	string	केवल स्टैंडर्ड फ़्लो। चेहरे का स्थिर, अपारदर्शी आइडेंटिफ़ायर (100 वर्णों तक)। एक ही व्यक्ति हमेशा एक ही मान पर resolve होता है।
data.​humanTokenMatch	string	केवल रीवैलिडेशन फ़्लो। "true" यदि सेल्फी संदर्भित humanToken से मेल खाती है, अन्यथा "false"।

state के मान

मान	अर्थ
PROCESS_STATE_UNSPECIFIED	स्थिति निर्धारित नहीं है।
PROCESS_STATE_CREATED	प्रोसेस बनाया गया है और अभी भी नए सेशन स्वीकार करता है। data का मान {} है।
PROCESS_STATE_FINISHED	प्रोसेस पूरा हो गया है और अब नए सेशन स्वीकार नहीं करता। स्टैंडर्ड फ़्लो के लिए, Human Token बनने पर data.humanToken मौजूद होता है; रीवैलिडेशन फ़्लो के लिए, data.humanTokenMatch इंगित करता है कि सेल्फी संदर्भित टोकन से मेल खाती है या नहीं। अन्यथा data का मान {} होता है।
PROCESS_STATE_FAILED	प्रोसेस विफल हुआ। data का मान {} है।
PROCESS_STATE_CANCELED	प्रोसेस रद्द किया गया। data का मान {} है।
PROCESS_STATE_AWAITING_FOR_DOCUMENT	प्रोसेस पहचान दस्तावेज़ की प्रतीक्षा कर रहा है। data का मान {} है।

चेतावनी

data.humanToken.value का उपयोग करने से पहले हमेशा जाँचें कि यह खाली नहीं है।

एरर कोड

400 Bad Request

कोड	Message	विवरण
3	process id is invalid	जब प्रोसेस ID अमान्य होती है।

401 Unauthorized

x-unico-accesskey हेडर में access key अनुपस्थित या अमान्य है। देखें ऑथेंटिकेशन।

404 Not Found

कोड	Message	विवरण
5	error getting process: rpc error: code = NotFound desc = process not found	जब प्रोसेस ID नहीं मिली।

429 Too Many Requests

रेट लिमिट पूरी हो गई। जब आपका सिस्टम HTTP 429 त्रुटि प्राप्त करता है, तो आपको कैस्केडिंग विफलताओं को रोकने और प्रतिबंध को बढ़ने से बचाने के लिए तंत्र लागू करने होंगे।

सर्वोत्तम प्रथाएं:

• कूल-डाउन अवधि (backoff): अपने सिस्टम से आने वाले बाद के अनुरोधों को तुरंत रोकें या कम करें। विफल अनुरोधों को लगातार एक तंग लूप में पुनः प्रयास न करें।
• कतार और थ्रॉटलिंग (Queueing & throttling): ट्रैफ़िक प्रवाह को नियंत्रित करने के लिए अपनी तरफ से आउटगोइंग अनुरोधों को बफ़र या कतार में रखें और फिर उन्हें पुनः भेजें।
• एक्सपोनेंशियल बैकऑफ़ विद जिटर (Exponential backoff with jitter): पुनः प्रयास करते समय, प्रयासों के बीच प्रतीक्षा समय को तेजी से बढ़ाएं (उदा., 1 s, 2 s, 4 s, 8 s) और एक छोटा यादृच्छिक विलंब ("jitter") जोड़ें ताकि हर्ड इफ़ेक्ट से बचा जा सके जहां सभी कतार में रखे गए अनुरोध ठीक उसी मिलीसेकंड पर पुनः प्रयास करते हैं।

चेतावनी

बैकऑफ़ लागू किए बिना रेट-लिमिटेड एंडपॉइंट को लगातार हिट करना प्रतिबंध अवधि को बढ़ा सकता है और आपके सिस्टम के परिचालन थ्रूपुट को गंभीर रूप से प्रभावित कर सकता है। अपनी तरफ से अनुरोधों को ठीक से थ्रॉटल करना एक सहज और अधिक लचीला एकीकरण सुनिश्चित करता है।

डिफ़ॉल्ट सीमाओं, अनुरोध बढ़ाने और अतिरिक्त विवरण के लिए, देखें रेट लिमिट।

500 Internal Server Error

कोड	Message	विवरण
99999	Internal failure! Try again later	जब कोई आंतरिक त्रुटि होती है।

आगे क्या

• नई सेल्फी भेजने के लिए प्रोसेस बनाएं पर वापस जाएँ।
• यह समझने के लिए कि humanToken क्या दर्शाता है और यह कब जनरेट नहीं होता, Human Token अवलोकन देखें।