दक्षिण अफ़्रीका ड्राइविंग लाइसेंस सत्यापन API

​

कवरेज

• कवरेज: —
• देश: दक्षिण अफ़्रीका
• सेवा ID: zaf_drivers_license
• डेटा डोमेन: पहचान
• श्रेणी: DriverLicence

​

इनपुट

• आवश्यक इनपुट: national_id, last_name, initials, licence_number
• वैकल्पिक इनपुट: first_name, date_of_birth, vendor_data
• सहमति: आवश्यक नहीं
• वर्कफ़्लो में उपलब्धता: फ़ील्ड मैपिंग के साथ वर्कफ़्लो में उपलब्ध
• कवरेज: —
• कीमत: प्रति सफल क्वेरी $0.80

​

बॉडी पैरामीटर

​

इनपुट नियम और सत्यापन नोट्स

• ऊपर सूचीबद्ध फ़ील्ड को ठीक वैसे ही भेजें जैसे वे उपयोगकर्ता या दस्तावेज़ से कैप्चर किए गए हों।
• Didit डेटाबेस को कॉल करने से पहले आवश्यक फ़ील्ड की जाँच करता है। स्रोत तक पहुँचने से पहले अस्वीकार किए गए अनुरोधों पर शुल्क नहीं लगता।

​

इसे कैसे कॉल करें

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_drivers_license" \
  -F "vendor_data=user-1234" \
  -F "national_id=SAMPLE-NID-12345" \
  -F "last_name=Doe" \
  -F "initials=JD" \
  -F "licence_number=LIC123456"

{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "expiration_date": "2030-05-31",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "vehicle_codes": "EB"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": null,
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "licence_valid": false
      },
      "validation": {}
    }
  ]
}

{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "ZAF",
  "match_type": null,
  "validations": [
    {
      "outcome_code": "INCONCLUSIVE",
      "service_id": "zaf_drivers_license",
      "service_name": "South Africa - Driving License Verification",
      "source_data": {
        "licence_valid": true
      },
      "validation": {}
    }
  ]
}

​

लौटाया गया डेटा

• expiration_date
• first_name
• identification_number
• last_name
• licence_valid
• vehicle_codes

​

मूल्य निर्धारण और SLA

• प्रति कॉल कीमत: $0.80 USD।
• बिलिंग: प्रति सफल क्वेरी। जब रजिस्ट्री तक पहुँचा न जा सके, आवश्यक फ़ील्ड गायब हों, या अनुरोध स्रोत तक पहुँचने से पहले अस्वीकार हो जाए, तब आपसे शुल्क नहीं लिया जाता।
• विलंबता: सामान्य p95 < 2 सेकंड।
• उपलब्धता: Didit की ओर से प्रति तिमाही 99.9%; डाउनस्ट्रीम स्रोत की उपलब्धता देश और डेटासेट के अनुसार अलग होती है।

​

जाँच के परिणामों का अर्थ

• MATCH - रजिस्टर ने इस लाइसेंस नंबर का लाइसेंस रिकॉर्ड लौटाया, और आपके द्वारा भेजा गया विवरण उससे मेल खाता है। source_data में वह रिकॉर्ड होता है: identification_number (लाइसेंस नंबर), first_name और last_name, vehicle_codes (लाइसेंस की श्रेणियाँ, जैसे EB, C1) और expiration_date (लाइसेंस कार्ड की समाप्ति तिथि)।
• INCONCLUSIVE - रजिस्टर ने अनुरोध स्वीकार किया, लेकिन कोई लाइसेंस रिकॉर्ड नहीं लौटाया, इसलिए भेजे गए विवरण की तुलना करने के लिए कुछ नहीं था। इस मामले में source_data.licence_valid का मान true होता है, validation खाली होता है और match_type null होता है। लाइसेंस के बारे में कुछ भी पुष्ट नहीं होता, इसलिए जाँच समीक्षा के लिए भेजी जाती है। यही बात तब भी लागू होती है जब उसी अनुरोध में कोई दूसरी सेवा, जैसे राष्ट्रीय ID जाँच, व्यक्ति का मिलान हो गया हो, क्योंकि वह व्यक्ति की पुष्टि करती है, लाइसेंस की नहीं।
• NO_MATCH - रजिस्टर ने लाइसेंस की खोज की और उसे मान्य नहीं पाया (source_data.licence_valid: false)। आपकी नो-मैच कार्रवाई लागू होती है।
• REGISTRY_ERROR - रजिस्टर ने खोज नहीं की, इसलिए लाइसेंस के बारे में कुछ भी स्थापित नहीं हुआ। जाँच समीक्षा के लिए भेजी जाती है और उसका बिल नहीं बनता।

​

आगे पढ़ें

• दक्षिण अफ़्रीका डेटाबेस सत्यापन का अवलोकन
• डेटाबेस सत्यापन का अवलोकन
• परिणाम कोड