अवलोकन
यह अनुभाग API contract (आंतरिक रूप से TCA / Check.Integration के रूप में जाना जाता है) को दस्तावेज़ करता है, जिसका उपयोग तब किया जाता है जब client application कैप्चर चरण का स्वामित्व रखती है और छवि सीधे प्लेटफ़ॉर्म पर भेजती है।
API contract का उपयोग तब करें जब:
- आपकी application पहले से ही selfie या छवि कैप्चर कर चुकी है (Unico के native SDK के माध्यम से या एक proprietary stack के माध्यम से — Capture Standard)।
- आप process-creation प्रतिक्रिया में ही synchronous परिणाम चाहते हैं।
- आप उपयोगकर्ता को किसी hosted journey पर redirect नहीं करना चाहते।
- आपका architecture पारंपरिक server-to-server calls (request → परिणाम के साथ response) को प्राथमिकता देता है।
यदि आप Unico को journey host करने देना चाहते हैं, तो इसके बजाय Web & SDK का उपयोग करें।
कैप्चर की गई छवि सीधे भेजकर सत्यापन प्रक्रिया बनाएं। तत्काल परिणाम लौटाता है।
पहचानकर्ता द्वारा मौजूदा API-contract प्रक्रिया पुनः प्राप्त करें।
नया कैप्चर फ्लो शुरू करने से पहले जाँचें कि उपयोगकर्ता क े पास पहले से कोई पुनः उपयोग योग्य दस्तावेज़ उपलब्ध है या नहीं।
नया दस्तावेज़ कैप्चर करें या किसी biometric process से जुड़े पहले कैप्चर किए गए दस्तावेज़ का पुनः उपयोग करें।
किसी दिए गए CPF के लिए पंजीकरण डेटा, PEP/AML जांच और खेल संबंध की क्वेरी करें।
आपके mobile application के अंदर selfie कैप्चर करने के लिए Android, iOS और Flutter की native libraries।
Unico के SDK का उपयोग न करने पर आपके proprietary कैप्चर को जिन तकनीकी आवश्यकताओं को पूरा करना होगा — resolution, format, lighting, और अधिक।
Web & SDK से अंतर
| पहलू | API | Web & SDK |
|---|---|---|
| प्रक्रिया कब बनाई जाती है | कैप्चर के बाद | कैप्चर से पहले |
| छवि वापसी | तत्काल (client-side कैप्चर के बाद) | समर्पित endpoint के माध्यम से |
| Journey नियंत्रण | Client | Unico |
| कैप्चर नियंत्रण | Client (SDK के साथ या बिना) | Unico |
| पहचान | subject.code | person.duiType + person.duiValue |
| Headers | Authorization + APIKEY | केवल Authorization |
| परिणाम schema | Flat (unicoId.result, liveness, आदि) | Nested (process.authenticationInfo.*Result) |
आगे क्या है
- Create Process — पूर्ण Onboarding contract।
- Error codes — 4xx और 5xx प्रतिक्रियाएँ संभालें।