document_subtype उस विशिष्ट दस्तावेज़ वैरिएंट की पहचान करता है जिसे Didit ने पहचाना है — उदाहरण के लिए जेनेरिक ड्राइविंग लाइसेंस के विपरीत क्वींसलैंड ड्राइविंग लाइसेंस, या मानक लाइसेंस के विपरीत एक अमेरिकी Commercial Driver’s License। यह पेज हर उस मान को सूचीबद्ध करता है जो यह फ़ील्ड लौटा सकती है।
आपका अपना वर्कफ़्लो इनमें से केवल एक सबसेट को स्वीकार करता है — जिसे आपने वर्कफ़्लो के दस्तावेज़-सेटिंग चरण में चुना है। यह मानने के बजाय कि नीचे दिया गया प्रत्येक मान आपके लिए सक्षम है, Management API के workflow-retrieve endpoint (OCR नोड पर
documents_allowed) के साथ अपने वर्कफ़्लो के लिए सटीक स्वीकृत सूची प्राप्त करें।नामकरण पैटर्न
प्रत्येकdocument_subtype मान दो प्रारूपों में से एक होता है:
- बेयर कैटेगरी —
{CATEGORY}, उन दस्तावेज़ों के लिए जिन्हें Didit को क्षेत्र के अनुसार अलग करने की आवश्यकता नहीं होती है (अधिकांश पासपोर्ट, अधिकांश राष्ट्रीय पहचान पत्र), उदाहरण के लिएPASSPORT_GENERIC,ID_CARD_GENERIC। - क्षेत्र-प्रीफ़िक्स वाला —
{REGION}_{CATEGORY}, उन दस्तावेज़ों के लिए जिनका प्रारूप या वर्गीकरण वास्तव में राज्य, प्रांत या क्षेत्र के अनुसार भिन्न होता है, उदाहरण के लिएQUEENSLAND_DRIVER_LICENSE_GENERIC(ऑस्ट्रेलिया) याCALIFORNIA_COMMERCIAL_DL(संयुक्त राज्य अमेरिका)। क्षेत्र का प्रीफ़िक्स जारीकर्ता राज्य/प्रांत का नाम होता है, जो बड़े अक्षरों में होता है और स्पेस को अंडरस्कोर से बदल दिया जाता है।
सभी सब-टाइप मान
नीचे दी गई तालिकाdocument_subtype मानों की पूरी सूची है जिसे रिपोर्ट लौटा सकती है, जिसे document_type फ़ैमिली द्वारा समूहीकृत किया गया है। इसमें पहले से ही क्षेत्र-प्रीफ़िक्स वाले वैरिएंट शामिल हैं — उदाहरण के लिए DRIVER_LICENSE_GENERIC (अधिकांश देश) और CALIFORNIA_DRIVER_LICENSE_GENERIC दोनों Driver’s License के तहत अलग-अलग पंक्तियों के रूप में दिखाई देते हैं।
एक बेयर-कैटेगरी कोड किसी एक देश के लिए विशिष्ट नहीं होता है — यह उन सभी देशों द्वारा साझा किया जाता है जिनकी उस दस्तावेज़ के लिए रजिस्ट्री प्रविष्टि में कोई क्षेत्र-विशिष्ट वैरिएंट नहीं है। उदाहरण के लिए, ID_CARD_GENERIC लगभग 170 देशों के राष्ट्रीय पहचान पत्रों को कवर करता है। किसी कोड को केवल उसके document_type समूह और (उपस्थित होने पर) उसके क्षेत्र के प्रीफ़िक्स द्वारा देखें, यह कभी न मानें कि एक कोड केवल एक ही देश से मैप होता है।
अमेरिकी ड्राइविंग लाइसेंस: मानक बनाम व्यावसायिक (CDL)
मानक ड्राइविंग लाइसेंस और Commercial Driver’s License (CDL) दोनों के लिएdocument_type का मान "Driver's License" होता है — यह कभी भी उनमें अंतर नहीं करता है। यह अंतर पूरी तरह से document_subtype में होता है।
Didit द्वारा वर्गीकृत 51 अमेरिकी राज्यों और क्षेत्रों में से 48 में, CDL को अपना स्वयं का {STATE}_COMMERCIAL_DL सब-टाइप मिलता है, जो उस राज्य के {STATE}_DRIVER_LICENSE_GENERIC से अलग होता है। _COMMERCIAL_DL पर समाप्त होने वाले document_subtype को “यह एक CDL है” के रूप में मानना उन राज्यों में एक विश्वसनीय संकेत है।
extra_fields.dl_categories विश्वसनीय CDL संकेत नहीं है
कुछ अमेरिकी लाइसेंस extra_fields.dl_categories भी उत्पन्न करते हैं — कार्ड पर छपे वर्ग अक्षरों (A, B, C, …) की एक सूची, जिसे OCR के माध्यम से पढ़ा जाता है। इसे अपने CDL संकेत के रूप में उपयोग न करें। वर्तमान में यह फ़ील्ड केवल अमेरिकी ड्राइविंग लाइसेंस कॉन्फ़िगरेशन के एक छोटे से हिस्से के लिए भरी जाती है, वर्ग-अक्षर के अर्थ राज्य के अनुसार भिन्न होते हैं और व्यावसायिक/गैर-व्यावसायिक अर्थों के लिए सामान्यीकृत नहीं होते हैं, और एंडोर्समेंट या प्रतिबंध कोड (जहां वास्तव में कई लाइसेंसों पर “commercial” चिह्नित होता है) वर्तमान में रिपोर्ट पर बिल्कुल भी प्रदर्शित नहीं होते हैं। मानक बनाम व्यावसायिक के अंतर के लिए वर्तमान में document_subtype ही एकमात्र संरचित, विश्वसनीय संकेत है।
समन्वय बनाए रखना
नएdocument_type परिवारों की घोषणा रिलीज़ होने पर मासिक चेंजलॉग में की जाती है। document_subtype परिवर्धन — उदाहरण के लिए किसी मौजूदा दस्तावेज़ प्रकार का एक नया क्षेत्रीय वैरिएंट — वर्तमान में व्यक्तिगत रूप से घोषित नहीं किए जाते हैं; जैसे-जैसे नए दस्तावेज़ प्रारूप जोड़े जाते हैं, Didit की दस्तावेज़ रजिस्ट्री लगातार बढ़ती जाती है। इस सूची के लिए webhook payload पर कोई संस्करण संख्या नहीं है।
यदि आपके इंटीग्रेशन को यह मानने के बजाय कि सेट निश्चित है, किसी ऐसे सब-टाइप का पता लगाने की आवश्यकता है जिसे उसने पहले कभी नहीं देखा है, तो किसी भी ऐसे document_subtype मान को जिसे आपका कोड नहीं पहचानता है, त्रुटि देने के बजाय “अवर्गीकृत, मैन्युअल रूप से समीक्षा करें” के रूप में मानें, और समय-समय पर इस पेज या Management API के माध्यम से अपने वर्कफ़्लो की स्वीकृत सब-टाइप सूची की पुनः जाँच करें।
संबंधित
- पहचान सत्यापन रिपोर्ट — संदर्भ में
document_type/document_subtypeफ़ील्ड। - समर्थित पहचान दस्तावेज़ — Didit द्वारा समर्थित देश और दस्तावेज़ प्रकार।
- डेटा मॉडल — पहचान सत्यापन — विहित फ़ील्ड स्कीमा।