पासपोर्ट पार्सर को एक तोहफ़ा देता है: मशीन-रीडेबल ज़ोन (MRZ)। डेटा पेज के निचले किनारे पर बड़े अक्षरों, अंकों और < फ़िलर का एक ब्लॉक, जिसके फ़ील्ड पर चेक डिजिट गिने गए होते हैं। ज़ोन पढ़िए, डिजिट दोबारा गिनिए, और किसी भी फ़ील्ड पर भरोसा करने से पहले आप जान जाते हैं कि रीडिंग आपस में मेल खाती है या नहीं।

ड्राइविंग लाइसेंस आम तौर पर आपको इनमें से कुछ नहीं देता। ज़्यादातर जारीकर्ता लाइसेंस पर मशीन-रीडेबल ज़ोन छापते ही नहीं, इसलिए दोबारा गिनने के लिए कुछ होता ही नहीं। जिन डेवलपर्स ने अपनी पहली पाइपलाइन पासपोर्ट पर बनाई थी, वे अक्सर यह बात मुश्किल से सीखते हैं: "MRZ की जाँच करने वाला" कोड बिना ज़ोन वाले कार्ड से टकराता है और एक बिल्कुल सही लाइसेंस को एरर मानने लगता है।

यह पोस्ट इसी स्थिति के बारे में है। ज़ोन की जगह लाइसेंस में क्या होता है, कोई रिकग्निशन API उसके बारे में आपको क्या बता सकता है और क्या नहीं, और जब भरोसे के लिए चेक डिजिट न हों तब फ़ील्ड की जाँच ख़ुद कैसे करें। AAMVA और EU स्रोतों के उद्धरणों का मूल पाठ अंग्रेज़ी में है और अनुवाद हमारे अपने हैं।

यह doc.cheap का ब्लॉग है, जो एक पासपोर्ट और ID OCR API है। प्रोडक्ट वाला हिस्सा यह ध्यान में रखकर पढ़ें।

इसकी जगह लाइसेंस में क्या होता है

लाइसेंस का कोई एक फ़ॉर्मैट नहीं है। हर जारीकर्ता अपना कार्ड ख़ुद डिज़ाइन करता है, और जो मानक मौजूद हैं वे यह तय करते हैं कि कार्ड में क्या होना चाहिए और उसका लेआउट कैसा हो, न कि पार्स करने के लिए कोई एक तय स्ट्रिंग।

उत्तरी अमेरिका: पीछे की तरफ़ एक बारकोड। American Association of Motor Vehicle Administrators अपने सदस्यों के जारी किए कार्डों के लिए AAMVA DL/ID Card Design Standard प्रकाशित करता है। इसके 2026 संस्करण में "अनिवार्य PDF417 बारकोड" नाम का एक परिशिष्ट है, जिसमें लिखा है: "PDF417 द्वि-आयामी बारकोड सिंबोलॉजी वह न्यूनतम अनिवार्य मशीन-रीडेबल तकनीक है जो मानक के अनुरूप DL/ID दस्तावेज़ों पर मौजूद होनी चाहिए।" वही परिशिष्ट आगे कहता है: "सभी अनिवार्य और वैकल्पिक डेटा अनएन्क्रिप्टेड होना चाहिए।" यानी मानक के अनुरूप कार्ड धारक का डेटा दो बार रखता है – सामने छपा हुआ, और एक द्वि-आयामी बारकोड में एन्कोड किया हुआ, जिसे डिकोडर वाला कोई भी पढ़ सकता है।

EU: एक मानक कार्ड मॉडल, जिसे उसके सामने वाले हिस्से से पढ़ा जाता है। EU का लाइसेंस बदलने और मान्यता पर Your Europe पेज मौजूदा लाइसेंस को "नया EU मानक फ़ॉर्मैट (प्लास्टिक, क्रेडिट कार्ड के आकार का फ़ोटो कार्ड)" बताता है। लेआउट साझा है, लेकिन उससे आप जो पढ़ते हैं वह छपा हुआ टेक्स्ट है। पुराने कागज़ी लाइसेंस भी अभी चलन में हैं: वही पेज कहता है "अगर आपके पास पुराने तरह का EU लाइसेंस है, तो आप उसे अब भी सभी EU देशों में इस्तेमाल कर सकते हैं", और यह कि ऐसे लाइसेंस को "ज़्यादा से ज़्यादा 2033 तक" बदलवाना होगा।

अंतरराष्ट्रीय स्तर। AAMVA का अपना पेज बताता है कि अंतरराष्ट्रीय लाइसेंस मानक पर काम ISO में होता है, और यह कि "अंतरराष्ट्रीय मानक (18013) मोटर वाहन ड्राइवर लाइसेंस (DL) के फ़ॉर्मैट और सामग्री के लिए दिशानिर्देश तय करता है"। वह उन तकनीकों की सूची देता है जिन्हें मानक कवर करता है, जिनमें "बारकोड, एक-आयामी और द्वि-आयामी" और "ऑप्टिकल कैरेक्टर रिकग्निशन" शामिल हैं। दूसरे शब्दों में, मानक जारीकर्ता को चुनने देता है; वह आपको चेक डिजिट वाला कोई ज़ोन नहीं देता।

पार्सर के लिए इसका व्यावहारिक नतीजा:

पासपोर्ट ड्राइविंग लाइसेंस
मशीन-रीडेबल ज़ोन हमेशा, डेटा पेज पर आम तौर पर नहीं
दोबारा गिने जा सकने वाले चेक डिजिट हाँ, ज़ोन पर कोई नहीं, जब ज़ोन न हो
डेटा की दूसरी कॉपी ज़ोन बारकोड, अगर जारीकर्ता छापता है (आम तौर पर पीछे)
समाप्ति तिथि डेटा पेज पर छपी छपी, अगर लाइसेंस की कोई समाप्ति तिथि हो; कुछ आजीवन वैध होते हैं
क्या बताता है कि रीडिंग सुसंगत है ज़ोन बनाम छपा हुआ पेज छपे फ़ील्ड पर आपकी अपनी जाँचें

"ज़ोन नहीं" का मतलब "अमान्य" क्यों नहीं होना चाहिए

अगर आपकी पाइपलाइन पासपोर्ट से शुरू हुई थी, तो शायद वह ज़ोन के आधार पर शाखाओं में बँटती है: पास हुआ, आगे बढ़ो; फ़ेल हुआ, नई फ़ोटो माँगो। लाइसेंस एक तीसरा जवाब जोड़ता है, और सबसे आम वही है।

doc.cheap ज़ोन को एक ही फ़ैसले, mrz.status, के रूप में बताता है, जिसके तीन मान हैं। passed का मतलब है कि ज़ोन मौजूद है और हर चेक डिजिट सही निकला। failed का मतलब है कि एक ज़ोन पढ़ा गया और उसमें कुछ मेल नहीं खाया। absent का मतलब है कि दस्तावेज़ पर ज़ोन है ही नहीं – और तब reason, lines और text सभी null होते हैं। ड्राइविंग लाइसेंस गाइड इसे साफ़ कहती है: "absent को एरर नहीं, एक सामान्य नतीजा मानें।"

दस्तावेज़ का बाक़ी हिस्सा इससे प्रभावित नहीं होता। लाइसेंस किसी भी दूसरे दस्तावेज़ की तरह अपने छपे हुए सामने वाले हिस्से से पहचाना जाता है, और meta.status का मान recognized आता है। इसलिए आपको जो शाखा चाहिए वह "ज़ोन पास या रिजेक्ट" नहीं, बल्कि यह है:

  • failed – ज़ोन में कुछ मेल नहीं खाया; बेहतर फ़ोटो माँगें।
  • passed – ज़ोन की जाँच सही रही; आगे बढ़ें।
  • absent – जाँचने के लिए कुछ नहीं था; नीचे दी गई अपनी फ़ील्ड जाँचों पर जाएँ।

एक API कॉल से लाइसेंस पढ़ना

लाइसेंस उसी एंडपॉइंट पर जाता है जिस पर पासपोर्ट, उसी बॉडी के साथ: एक POST /v1/scans, जिसमें फ़ोटो base64 में एन्कोड होकर JSON के अंदर होती है। पब्लिक सैंडबॉक्स कुंजी sk_sandbox_public बिना अकाउंट के काम करती है। इसके साथ टेस्ट इमेज इस्तेमाल करें, असली लाइसेंस कभी नहीं: पब्लिक कुंजी पर किया गया हर स्कैन सेवा के अपने लॉग के लिए एक साल तक रखा जाता है।

curl -X POST https://api.doc.cheap/v1/scans \
  -H "Authorization: Bearer sk_sandbox_public" \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < licence-front.jpg | tr -d '\n')\"}"

लाइसेंस के लिए जवाब के ज़रूरी हिस्से कुछ ऐसे दिखते हैं। हर मान काल्पनिक है, और जारी करने वाला राज्य UTO है, वह काल्पनिक राज्य जिसे नमूना (स्पेसिमेन) दस्तावेज़ इस्तेमाल करते हैं:

{
  "meta": { "status": "recognized", "billed": true, "confidence": "high" },
  "document": {
    "country": "UTO",
    "number": "DL0000000",
    "issue_date": "2024-05-02",
    "expiry_date": "2034-05-01",
    "is_expired": false,
    "days_remaining": 2725
  },
  "holder": {
    "surname": "SPECIMEN",
    "given_names": "ALEX JORDAN",
    "birth_date": "1990-01-01"
  },
  "fields": [
    { "id": "dl_class@0", "name": "dl_class", "label": "Driving-licence class",
      "category": "document", "value": "B, BE", "language": "English", "confidence": "high" },
    { "id": "authority@0", "name": "authority", "label": "Issuing authority",
      "category": "document", "value": "UTOPIA LICENSING OFFICE", "language": "English", "confidence": "medium" }
  ],
  "mrz": { "status": "absent", "reason": null, "lines": null, "text": null },
  "authenticity": { "overall": "not_checked", "checks": [] }
}

इसमें क्या पढ़ें:

  • fields वह जगह है जहाँ लाइसेंस से जुड़ा डेटा रहता है। फ़ील्ड कैटलॉग बताता है कि लाइसेंस में आम तौर पर क्या होता है: surname, given_names, birth_date, document_number, dl_class या permit_class, issue_date, expiry_date, address और authority। पते के हिस्से (address_street, address_city, address_state, address_postal_code) पूरे पते के साथ-साथ अलग-अलग भी दिए जाते हैं। यह सेट खुला है, इसलिए जिस फ़ील्ड का नाम शब्दावली में नहीं है, वह भी other श्रेणी के तहत दिया जाता है।
  • कुंजी id पर रखें, name पर नहीं। दो लिपियों में छपा लाइसेंस एक ही name के तहत हर भाषा के लिए एक एंट्री लौटाता है; सिर्फ़ id अनोखा होता है।
  • document.expiry_date, is_expired और days_remaining छपी हुई समाप्ति तिथि से, स्कैन के दिन से गिनकर निकाले जाते हैं।

बारकोड क्या जोड़ता है, और API उसके साथ क्या करता है

डिकोड किए गए बारकोड को जवाब में अपना अलग समूह नहीं मिलता। उसके मान बाक़ी सब के साथ fields में आते हैं, और जब उसे काटा जा सके तो images.barcode में उसकी कटी हुई इमेज होती है।

एक व्यावहारिक पेच है। एंडपॉइंट हर कॉल में एक इमेज पढ़ता है, और जो जारीकर्ता बारकोड छापता है वह उसे आम तौर पर कार्ड के पीछे रखता है। जब आपको बारकोड का डेटा चाहिए, तो पीछे का हिस्सा अलग स्कैन के रूप में भेजें और दोनों नतीजों को ख़ुद मिलाएँ। यही मिलान चेक डिजिट का आपका सबसे अच्छा विकल्प भी है: एक ही कार्ड की दो स्वतंत्र रीडिंग, जिन्हें आपस में मेल खाना चाहिए।

बिना चेक डिजिट के लाइसेंस की जाँच

ज़ोन न हो तो सुसंगति आपकी ज़िम्मेदारी है। इनमें से कोई भी जाँच यह साबित नहीं करती कि लाइसेंस असली है; ये ग़लत रीडिंग और साफ़ तौर पर ग़लत इनपुट को आपके डेटाबेस तक पहुँचने से पहले पकड़ती हैं।

  1. तारीख़ें सही क्रम में। birth_date issue_date से पहले, issue_date स्कैन के दिन या उससे पहले, expiry_date issue_date के बाद। जो रीडिंग यह क्रम तोड़े, वह ग़लत रीडिंग या ख़राब फ़ोटो है।
  2. समाप्ति तिथि दस्तावेज़ से, किसी नियम से नहीं। वैधता अवधि जारीकर्ता के हिसाब से बदलती है – EU पेज का अपना उदाहरण साइप्रस का एक लाइसेंस है जो "इटली की तरह 10 साल के बजाय 15 साल के लिए वैध" है। तारीख़ कार्ड से पढ़ें; उसे गिनें नहीं।
  3. समाप्ति तिथि न होने की स्थिति के लिए तैयारी रखें। वही EU पेज "आजीवन वैध EU ड्राइविंग लाइसेंस" का ज़िक्र करता है। जब कोई समाप्ति तिथि नहीं पढ़ी गई, तो expiry_date, is_expired और days_remaining एक साथ null होते हैं, और व्युत्पन्न फ़ील्ड days_to_expire भी null होता है। तय करें कि तब आपका फ़्लो क्या करेगा; null को अनजाने में न समाप्त मानें, न वैध।
  4. सिर्फ़ मौजूदगी नहीं, श्रेणी। अगर आपको कार चलाने का लाइसेंस रखने वाला व्यक्ति चाहिए, तो सिर्फ़ यह न जाँचें कि लाइसेंस है, बल्कि dl_class या permit_class में वह श्रेणी खोजें। मान B, BE जैसा छपा टेक्स्ट होता है, इसलिए मिलान से पहले उसे अलग-अलग करें, और अपने क्षेत्राधिकार की तय की हुई श्रेणियों से मिलाएँ।
  5. आगे बनाम पीछे। जहाँ कार्ड पर बारकोड हो, दोनों तरफ़ स्कैन करें और नाम, जन्मतिथि और दस्तावेज़ संख्या की तुलना करें। मेल न खाए तो दूसरी फ़ोटो माँगना ठीक रहेगा।
  6. उपयोगकर्ता की भरी जानकारी से। holder.surname और holder.birth_date की तुलना उस फ़ॉर्म से करें जो आपके उपयोगकर्ता ने भरा है, दोनों को एक ही तरह से सामान्य करके।
  7. संकेत के रूप में कॉन्फ़िडेंस। हर रीडिंग के साथ एक स्तर आता है – high, medium या low। जिस फ़ील्ड पर आप निर्भर हैं, उस पर low स्तर नई फ़ोटो माँगने का अच्छा कारण है।

ज़ोन न होने पर स्कैन की लागत क्या है

लाइव कुंजी पर, स्कैन एक क्रेडिट तब लेता है जब दस्तावेज़ का प्रकार तय हो गया हो और इन तीन में से एक बात सही हो: ज़ोन पढ़ा गया और उसके चेक डिजिट सही निकले, विज़ुअल ज़ोन के पाँच या ज़्यादा फ़ील्ड पढ़े गए, या बारकोड डिकोड हुआ। इसलिए लाइसेंस पर दूसरी या तीसरी शर्त के आधार पर बिल बनता है। इतनी ख़राब फ़ोटो जिससे पाँच फ़ील्ड न निकलें और कोई बारकोड न हो, मुफ़्त है। बिलिंग नियम में पूरी परिभाषा है।

OCR आपको क्या नहीं बताता

लाइसेंस पढ़ना और उसका सत्यापन करना अलग-अलग काम हैं। doc.cheap वह पढ़ता है जो कार्ड पर छपा है, और पीछे की तरफ़ बारकोड। केवल रिकग्निशन वाले परिदृश्य में authenticity.overall का मान not_checked होता है, इसलिए यह नहीं बताता कि कार्ड असली है या नहीं, निलंबित है या नहीं, या उसे पकड़े व्यक्ति ही उसका मालिक है या नहीं। अगर आपके फ़्लो को इनमें से कुछ चाहिए, तो वे अलग चरण हैं, जिनके लिए बने टूल और रिकॉर्ड इस्तेमाल होते हैं।

आज़माकर देखें

पब्लिक सैंडबॉक्स कुंजी के लिए अकाउंट की ज़रूरत नहीं है। रजिस्टर करने पर आपको अपनी कुंजी पर हर महीने 100 मुफ़्त रिकग्निशन मिलते हैं, जो पूरा फ़्लो बनाने के लिए काफ़ी हैं – आगे का हिस्सा, पीछे का हिस्सा और आपकी अपनी जाँचें। अगर आप प्रोवाइडर चुन रहे हैं, तो पासपोर्ट OCR API तुलना प्रकाशित क़ीमतों को साथ-साथ रखती है, और ड्राइविंग लाइसेंस गाइड में curl, JavaScript और Python में कॉल के साथ चमकदार कार्ड की फ़ोटो लेने के सुझाव भी हैं।

आपसे एक सवाल: जब लाइसेंस पर ज़ोन न हो, तो आपके फ़्लो में कौन-सी जाँच सबसे ज़्यादा ख़राब रीडिंग पकड़ती है – तारीख़ें, पीछे का बारकोड, या कुछ और? नीचे कमेंट में बताएँ।