भारत के पासपोर्ट की फ़ोटो भेजें और उसी HTTP रिस्पॉन्स में स्ट्रक्चर्ड डेटा पाएँ – पार्स किया गया मशीन-रीडेबल ज़ोन (MRZ), जाँचे हुए ICAO 9303 चेक डिजिट और निकाले गए विज़ुअल फ़ील्ड। न कोई SDK इंस्टॉल करना, न किसी क्यू को बार-बार जाँचना।
भारत का पासपोर्ट ICAO 9303 मानक का पालन करता है: डेटा पेज के निचले हिस्से में छपा दो लाइन और 44 अक्षरों वाला मशीन-रीडेबल ज़ोन (फ़ॉर्मैट TD3), जिसके ऊपर इंसान के पढ़ने के लिए विज़ुअल इंस्पेक्शन ज़ोन होता है। इसके पहले पाँच अक्षर P<IND हैं – पहले डॉक्यूमेंट कोड, फिर जारी करने वाला देश, ISO 3166-1 alpha-3 कोड IND के रूप में। API दोनों ज़ोन पढ़ता है, MRZ के चेक डिजिट को क्रॉस-चेक करता है, और रिस्पॉन्स की एक ही बनावट लौटाता है जिसमें हर की (key) मौजूद होती है।
भारत alpha-2 सूची में IN है और ज़ोन में IND: यहाँ लंबा कोड छोटे कोड के बाद D जोड़कर बनता है। यह इसी जोड़ी पर लागू होता है, नियम के रूप में नहीं, इसलिए एक से दूसरा निकालना एक ऐसा बग है जो उस पहले देश का इंतज़ार कर रहा है जिस पर यह फ़िट नहीं बैठता।
9303 तीन ज़ोन लेआउट तय करता है, और API तीनों पढ़ता है। नीचे हर लेआउट में एक काल्पनिक धारक है – वह कोई असली व्यक्ति नहीं है, और paradeigma ग्रीक में उदाहरण के लिए शब्द है – जिसमें जारी करने वाला देश IND है। हर चेक डिजिट हाथ से लिखने के बजाय बगल के अक्षरों से गणना करके निकाला गया है, इसलिए यहाँ का हर ज़ोन वैलिडेट होता है।
44-44 अक्षरों की 2 लाइनें। राष्ट्रीयता IND। जारी करने वाला देश और राष्ट्रीयता, दोनों IND हैं: पासपोर्ट उसी देश की राष्ट्रीयता प्रमाणित करता है जिसने उसे जारी किया है।
P<INDPARADEIGMA<<ELENI<SOFIA<<<<<<<<<<<<<<<<
AM73045184IND9403084F3203101PN48291630<<<<7236-36 अक्षरों की 2 लाइनें। राष्ट्रीयता GRC। IND द्वारा GRC राष्ट्रीयता वाले व्यक्ति को जारी, इसलिए दोनों कोड अलग हैं। यहाँ नाम में पासपोर्ट के 39 की जगह 31 अक्षर हैं।
I<INDPARADEIGMA<<ELENI<SOFIA<<<<<<<<
TR61850420GRC9403084F2911043<<<<<<<230-30 अक्षरों की 3 लाइनें। राष्ट्रीयता GRC। 30-30 अक्षरों की तीन लाइनें, और नाम अपनी अलग लाइन पर। डॉक्यूमेंट कोड ID है – 9303 का part 5 पहला अक्षर A, C या I तय करता है और दूसरा अक्षर जारी करने वाले देश पर छोड़ देता है।
IDINDAK472913<4PN48291630<<<<<
9403084F3405204GRC<<<<<<<<<<<9
PARADEIGMA<<ELENI<SOFIA<<<<<<<कोई भी चेक डिजिट जारी करने वाले देश को कवर नहीं करता: तीनों लेआउट में गणना डॉक्यूमेंट नंबर, तारीख़ों और वैकल्पिक डेटा पर होती है, उन तीन अक्षरों पर कभी नहीं जो बताते हैं कि डॉक्यूमेंट किसने जारी किया। जिस ज़ोन के सारे डिजिट सही निकलते हैं, उसने यह साबित नहीं किया कि वह भारत से आया है – यह काम विज़ुअल ज़ोन और डॉक्यूमेंट के अपने सुरक्षा फ़ीचर करते हैं।
किसी MRZ के चेक डिजिट वैलिडेट करने के लिए उसे MRZ पार्सर में पेस्ट करें, या MRZ जनरेटर से एक नया बनाएँ।
भारत का हर पहचाना गया पासपोर्ट एक जैसे स्ट्रक्चर्ड फ़ील्ड लौटाता है। जो वैल्यू पढ़ी नहीं जा सकी, वह null होती है, की (key) कभी ग़ायब नहीं होती।
हर फ़ील्ड डॉक्यूमेंट फ़ील्ड एक्सप्लोरर (अंग्रेज़ी में) में देखें।
इसे सार्वजनिक सैंडबॉक्स पर चलाएँ – बिना रजिस्ट्रेशन, असली पहचान, सीमित संख्या में डॉक्यूमेंट के लिए मुफ़्त और हर IP पर घंटे में 10 रिक्वेस्ट। भारत के पासपोर्ट पहचानते रहने के लिए सैंडबॉक्स कुंजी की जगह अपनी लाइव कुंजी लगाएँ।
curl -X POST https://api.doc.cheap/v1/scans \
-H "Authorization: Bearer sk_sandbox_public" \
-H "Content-Type: application/json" \
-d "{\"image\": \"$(base64 < document.jpg | tr -d '\n')\"}"यह पेज वह बताता है जो भारत के लिए ख़ास है। बाक़ी सब कुछ नीचे दिए चार पेजों (अंग्रेज़ी में) में है।
ऊपर वाली कॉल एक असली डॉक्यूमेंट के साथ, curl, JavaScript और Python में, और जवाब की हर की (key) की व्याख्या।
डॉक्यूमेंट एक ही जानकारी दो बार क्यों छापता है, दोनों मेल न खाएँ तो किस ज़ोन पर भरोसा करें, और ऊपर के चेक डिजिट क्या साबित कर सकते हैं और क्या नहीं।
ज़ोन लैटिन लिप्यंतरण है; विज़ुअल ज़ोन नहीं। कौन-सी रीडिंग मूल लिपि रखती है, और भाषा का आइडेंटिफ़ायर किसी भाषा तक कैसे पहुँचता है।
हर एरर कोड जिसके साथ API जवाब दे सकता है, एक टेबल में: उसकी वजह क्या है, दोबारा कोशिश सफल हो सकती है या नहीं, और कॉल का शुल्क लगा या नहीं।
पहली सफल कॉल 60 सेकंड से कम में, 1¢ प्रति डॉक्यूमेंट, और डॉक्यूमेंट की इमेज कभी सेव नहीं होती।
आप केवल उन्हीं डॉक्यूमेंट का भुगतान करते हैं जिन्हें हम सच में पहचान पाते हैं।
धुंधली फ़ोटो, फ़्रेम में कोई डॉक्यूमेंट नहीं, अनजान प्रकार – मुफ़्त। असफल स्कैन के लिए आप कभी भुगतान नहीं करते।