रीप्रोसेसिंग और बायोमेट्रिक बेस इम्पोर्ट

यह गाइड Unico प्लेटफ़ॉर्म पर रीप्रोसेसिंग या बायोमेट्रिक बेस इम्पोर्ट करने का तरीका बताती है। यह प्लेटफ़ॉर्म की सर्वोत्तम प्रथाओं का पालन करते हुए एक प्रभावी, सुरक्षित एकीकरण के लिए तकनीकी और परिचालन आवश्यकताओं का विवरण देती है।

दायरा

यह सामग्री दो प्रकार की प्रक्रियाओं को कवर करती है:

• रीप्रोसेसिंग: उन उपयोगकर्ताओं के बायोमेट्रिक रिकॉर्ड का पुनर्प्रसंस्करण जो पहले से क्लाइंट और Unico के बेस में हैं, पुनर्मूल्यांकन या सिस्टम के बीच माइग्रेशन के लिए।
• बायोमेट्रिक बेस इम्पोर्ट: पहचान सत्यापन और/या जोखिम वर्गीकरण उद्देश्यों के लिए सेल्फी युक्त बेस का प्रारंभिक अपलोड या अपडेट।
• दस्तावेज़ बेस इम्पोर्ट: Facematch या CPF Match सत्यापन उद्देश्यों के लिए सेल्फी के साथ दस्तावेज़ बेस का अपलोड (केवल ब्राज़ील)।

पूर्वापेक्षाएं

• क्लाइंट के पास Unico के साथ एक सक्रिय अनुबंध या NDA हस्ताक्षरित होना चाहिए और एकीकरण चरण में होना चाहिए (गवर्नेंस टीम द्वारा अनुमोदित होने पर अपवाद)।
• प्रोजेक्ट औपचारिक TPS (transactions per second) समझौतों का पालन करेगा। नीचे TPS समझौता देखें।
• प्रोडक्शन क्रेडेंशियल प्राप्त करने से पहले, डेटा गुणवत्ता, payload अनुपालन और स्थिर प्रदर्शन सुनिश्चित करने के लिए पूर्ण एकीकरण होमोलोगेशन अनिवार्य है।
• रीप्रोसेसिंग या इम्पोर्ट के लिए एक समर्पित सर्विस अकाउंट बनाया जाना चाहिए (उदा., "Reprocessing" या "Legacy_Import")।
• रीप्रोसेसिंग/इम्पोर्ट के लिए विशेष रूप से एक समर्पित API Key बनाई जाएगी।
• (वैकल्पिक) रीप्रोसेसिंग/इम्पोर्ट के लिए एक समर्पित subsidiary बनाई जा सकती है। इस पैरामीटर को payload में subsidiaryId के रूप में पहचाना जाता है। नीचे Payload पैरामीटर देखें।
• API Key और सर्विस अकाउंट सहमत अवधि या प्रोसेसिंग पूरी होने के बाद निष्क्रिय कर दिए जाएंगे।

उपलब्ध capabilities

Capability	विवरण
पहचान सत्यापन	सत्यापित करता है कि सबमिट की गई सेल्फी पहचानकर्ता के वास्तविक धारक की है या नहीं।
धोखाधड़ी जोखिम वर्गीकरण	उस चेहरे से जुड़े धोखाधड़ी व्यवहार के इतिहास की जांच करता है।
Facematch	सत्यापित करता है कि दस्तावेज़ की फ़ोटो सबमिट की गई सेल्फी से मेल खाती है या नहीं।
CPF Match Brazil only	सत्यापित करता है कि प्रदान किया गया CPF दस्तावेज़ पर मुद्रित CPF नंबर से मेल खाता है या नहीं। नोट: सभी RGs पर CPF मुद्रित नहीं होता।

सेल्फी आवश्यकताएं

• base64 प्रारूप में सबमिट की जानी चाहिए।
• छवि को ICAO मानक का पालन करना चाहिए (हल्की पृष्ठभूमि, केंद्रित चेहरा, पहचान में बाधा डालने वाले कोई एक्सेसरीज़ नहीं, उचित प्रकाश)।
• अनुशंसित आयाम: 1920x1080 या 1080x1920 अनुपात।
• अधिकतम आकार: 800 KB (आवश्यकता होने पर JPEG 92 से कंप्रेस करें)।
• ओरिएंटेशन: पोर्ट्रेट।

दस्तावेज़ आवश्यकताएं

• समर्थित दस्तावेज़ प्रकार: देखें दस्तावेज़ कैप्चर और पुनरुपयोग — समर्थित दस्तावेज़।
• छवियों में दस्तावेज़ का अगला और पिछला दोनों भाग पूरी तरह दिखना चाहिए, बिना किसी कटाव के।
• दस्तावेज़ पठनीय होना चाहिए — स्पष्ट, अच्छी तरह से प्रकाशित और बाधाओं से मुक्त।

TPS समझौता

• इस प्रोजेक्ट के लिए अधिकतम सहमत TPS 10 TPS है।
• बड़े बर्स्ट में भेजने के बजाय अनुरोधों को समय पर समान रूप से वितरित करें।
• Unico टीम की औपचारिक स्वीकृति के बिना इस सीमा को पार नहीं किया जाना चाहिए।
• सीमा से ऊपर के अनुरोध स्वचालित रूप से ड्रॉप या ब्लॉक किए जा सकते हैं।
• यदि अस्थायी वृद्धि की आवश्यकता है, तो एक औपचारिक पूर्व समझौता आवश्यक है।

एकीकरण

एंडपॉइंट

वातावरण	बेस URL	एक्सेस	नोट्स
Staging	https://api.id.uat.unico.app	खुला	परीक्षण के लिए अनिवार्य
Production	https://api.id.unico.app	केवल अनुमोदित होमोलोगेशन के बाद	सख्त TPS नियंत्रण आवश्यक

आवश्यक हेडर

Authorization: Bearer {access_token}
APIKEY: {your_api_key}
Content-Type: application/json

Payload पैरामीटर

{
  "subject": {
    "duiType": 1,
    "code": "11032395702",
    "name": "User Name",
    "email": "[email protected]",
    "phone": "21998571922",
    "birthDate": "30/07/1989",
    "gender": "M"
  },
  "useCase": "Reprocessamento/Importação",
  "subsidiaryId": "35d734c4-7fbb-4b2f-a1dc-7e1575514819",
  "imageBase64": "/9j/4AAQSkZJR...",
  "document": {
    "purpose": "Reprocessamento",
    "documentId": "doc-001",
    "files": [
      {
        "data": "doc_base64_frente",
        "faceDocumentMatch": true
      },
      {
        "data": "doc_base64_verso"
      }
    ]
  }
}

फ़ील्ड	प्रकार	आवश्यक	विवरण
subject	object	हां	उपयोगकर्ता पहचान डेटा।
subject.duiType	integer	हां	दस्तावेज़ प्रकार पहचानकर्ता। नीचे duiType मान देखें।
subject.code	string	हां	CPF या अन्य उपयोगकर्ता पहचानकर्ता।
subject.name	string	हां	उपयोगकर्ता का पूरा नाम।
subject.email	string	नहीं	उपयोगकर्ता का ईमेल।
subject.phone	string	नहीं	उपयोगकर्ता का फ़ोन नंबर।
subject.birthDate	string	नहीं	उपयोगकर्ता की जन्म तिथि (DD/MM/YYYY)।
subject.gender	string	नहीं	उपयोगकर्ता का लिंग (M या F)।
useCase	string	हां	उपयोग केस का नाम ("Reprocessamento" या "Importação de base")।
subsidiaryId	string	नहीं	Subsidiary UUID (Unico द्वारा प्रदान किया गया)।
imageBase64	base64	हां	उपयोगकर्ता की सेल्फी छवि base64 में रूपांतरित।
document	object	नहीं	प्रक्रिया से जुड़ा दस्तावेज़ डेटा।
document.purpose	string	नहीं	दस्तावेज़ का उद्देश्य (उदा., "Reprocessamento")।
document.documentId	string	नहीं	दस्तावेज़ पहचानकर्ता।
document.files	array	नहीं	दस्तावेज़ छवि फ़ाइलों की सूची।
document.files[].data	base64	नहीं	दस्तावेज़ छवि base64 में रूपांतरित।
document.files[].faceDocumentMatch	boolean	नहीं	इंगित करता है कि दस्तावेज़ में चेहरा सबमिट की गई सेल्फी से मेल खाता है या नहीं।

duiType मान

मान	विवरण
0	अनिर्दिष्ट
1	ब्राज़ील — CPF
2	मैक्सिको — CURP
3	Unico आंतरिक पहचानकर्ता
4	संयुक्त राज्य अमेरिका — SSN
5	ब्राज़ील — पासपोर्ट
6	अर्जेंटीना — पासपोर्ट
7	अर्जेंटीना — DNI
8	नाइजीरिया — NIN
9	चिली — RUN
10	इक्वाडोर — NI
11	संयुक्त राज्य अमेरिका — पासपोर्ट
12	ग्वाटेमाला — CUI
13	उरुग्वे — CI
15	ईमेल पता
16	इंडोनेशिया — NIK
17	फ़ोन नंबर
18	संयुक्त राज्य अमेरिका — ड्राइविंग लाइसेंस

महत्वपूर्ण नोट्स

• सेल्फी को उचित गुणवत्ता और प्रकाश के साथ ICAO मानक का अनुपालन करना चाहिए।
• सेल्फी base64 प्रारूप में होनी चाहिए।
• TPS नियंत्रण के बिना बल्क सबमिशन से बचें — इससे रेट लिमिटिंग ट्रिगर हो सकती है (नीचे त्रुटि प्रबंधन देखें)।
• हमेशा पहले staging वातावरण में डेटा और एकीकरण का परीक्षण करें।

रिस्पॉन्स

सफलता — 200 OK

दस्तावेज़ के बिना

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 3,
  "unicoId": {
    "result": "inconclusive"
  },
  "identityFraudsters": {
    "result": "inconclusive"
  }
}

फ़ील्ड	प्रकार	विवरण
id	string	प्रोसेस पहचानकर्ता। भविष्य की क्वेरी के लिए या बाद में 1:1 सत्यापन लागू करने पर इसे स्टोर करें।
status	integer	ट्रांजैक्शन स्थिति।
unicoId.result	string	पहचान सत्यापन capability रिस्पॉन्स।
identityFraudsters.result	string	धोखाधड़ी जोखिम वर्गीकरण capability रिस्पॉन्स।

दस्तावेज़ के साथ (Facematch)

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "score": 0,
  "status": 3,
  "unicoId": {
    "result": "yes"
  },
  "faceDocumentMatch": {
    "faceMatch": true
  },
  "identityFraudsters": {
    "result": "yes"
  }
}

फ़ील्ड	प्रकार	विवरण
id	string	प्रोसेस पहचानकर्ता। भविष्य की क्वेरी के लिए या बाद में 1:1 सत्यापन लागू करने पर इसे स्टोर करें।
status	integer	ट्रांजैक्शन स्थिति।
score	number	Facematch स्कोर।
unicoId.result	string	पहचान सत्यापन capability रिस्पॉन्स।
faceDocumentMatch.faceMatch	boolean	क्या दस्तावेज़ की फ़ोटो सबमिट की गई सेल्फी से मेल खाती है।
identityFraudsters.result	string	धोखाधड़ी जोखिम वर्गीकरण capability रिस्पॉन्स।

छवि प्रोसेसिंग त्रुटि

{
  "id": "80371b2a-3ac7-432e-866d-57fe37896ac6",
  "status": 5
}

सामान्य त्रुटियां

4xx श्रेणी के कोड प्रदान किए गए डेटा में सत्यापन त्रुटियों को दर्शाते हैं। 5xx श्रेणी के कोड सर्वर-साइड विफलताओं को दर्शाते हैं।

HTTP कोड	त्रुटि प्रकार	संभावित कारण	अनुशंसित कार्रवाई
400	Bad Request	अमान्य payload	संरचना और सामग्री को सत्यापित करें।
401	Unauthorized	समाप्त या अमान्य टोकन	टोकन पुनर्जनित करें।
403	Forbidden	गलत API Key या अपर्याप्त अनुमतियां	क्रेडेंशियल सत्यापित करें।
429	Too Many Requests	अनुरोध दर सीमा पार	प्रतीक्षा करें और TPS सीमा का सम्मान करें।
500+	Internal Server Error	आंतरिक विफलता	कुछ सेकंड बाद पुनः प्रयास करें; लगातार होने पर टिकट खोलें।

त्रुटि प्रबंधन

• Rate Limit (HTTP 429) की सावधानीपूर्वक निगरानी की जानी चाहिए। अनुरोध ओवरलोड पाइपलाइन को ब्लॉक कर सकता है।
• हमेशा Unico के साथ सहमत TPS का सम्मान करें (TPS समझौता देखें)।
• लगातार विफलताओं (5xx) के लिए, retry/backoff नियंत्रण के साथ रीप्रोसेस करें।