डेटाबेस सत्यापन चेतावनियाँ और स्किप कोड

Didit की डेटाबेस सत्यापन सुविधा आधिकारिक नागरिक रजिस्ट्रियों — RENAPER (अर्जेंटीना), Receita Federal (ब्राज़ील), Tribunal Electoral (पनामा, बायोमेट्रिक), Junta Central Electoral (डोमिनिकन गणराज्य), और अन्य — के विरुद्ध पहचान डेटा को सत्यापित करती है, जिसके लिए बिना किसी मासिक न्यूनतम सीमा के प्रति सफल क्वेरी के आधार पर बिलिंग की जाती है। जब कोई भी सेवा नहीं चल पाती है (आवश्यक फ़ील्ड अनुपलब्ध या विकृत हैं, रजिस्ट्री अनुपलब्ध है), दस्तावेज़ की स्वयं जांच नहीं की जा सकती (इसमें वह पहचानकर्ता शामिल नहीं है जिसकी कॉन्फ़िगर की गई सेवाओं को आवश्यकता होती है — उदा. राष्ट्रीय ID संख्या के बिना पासपोर्ट), या कुल परिणाम अनिर्णायक होता है (आंशिक मिलान, कोई मिलान नहीं), तो यह सुविधा सत्र पर एक चेतावनी जारी करती है। यदि वर्कफ़्लो में जारीकर्ता राज्य सक्षम ही नहीं है, तो चरण को बिना किसी चेतावनी और बिना किसी शुल्क के चुपचाप छोड़ दिया जाता है। यह पेज प्रत्येक चेतावनी कोड, इसे क्या ट्रिगर करता है, और वर्कफ़्लो रिस्पॉन्स को कैसे कॉन्फ़िगर करें, इसका विवरण देता है।

अवलोकन

चेतावनियाँ वर्कफ़्लो सत्रों और स्टैंडअलोन API (POST /v3/database-validation/) दोनों द्वारा उत्पन्न की जाती हैं। सभी पांच जोखिमों को सुविधा DATABASE_VALIDATION के साथ टैग किया गया है, ये रिपोर्ट पर database_validations[].warnings[] के अंतर्गत दिखाई देते हैं, और मानक चेतावनी ऑब्जेक्ट संरचना (feature, risk, additional_data, log_type, short_description, long_description, node_id) का पालन करते हैं। डेटाबेस सत्यापन के लिए स्वचालित अस्वीकृति के कोई कठोर ट्रिगर नहीं हैं। दो मिलान-परिणाम जोखिम, प्रतिस्थापित-दस्तावेज़ जोखिम और लागू नहीं होने वाला जोखिम एक कॉन्फ़िगर करने योग्य कार्रवाई (DECLINE, REVIEW, या NO_ACTION) से मैप होते हैं; COULD_NOT_PERFORM_DATABASE_VALIDATION एकमात्र निश्चित व्यवहार है — यह सुविधा को हमेशा समीक्षाधीन पर रूट करता है।

कॉन्फ़िगर करने योग्य जोखिम

सेटिंग	जोखिम कोड	व्यवहार
नो मैच कार्रवाई	`DATABASE_VALIDATION_NO_MATCH`	`REVIEW` (वर्कफ़्लो डिफ़ॉल्ट) सुविधा को समीक्षाधीन पर सेट करता है; `DECLINE` अस्वीकृत करता है; `NO_ACTION` स्थिति को प्रभावित किए बिना चेतावनी रिकॉर्ड करता है। स्टैंडअलोन API का `no_match_action` पैरामीटर इसके बजाय डिफ़ॉल्ट रूप से `DECLINE` होता है।
आंशिक मिलान कार्रवाई	`DATABASE_VALIDATION_PARTIAL_MATCH`	`NO_ACTION` (डिफ़ॉल्ट) स्थिति को प्रभावित किए बिना चेतावनी रिकॉर्ड करता है; `REVIEW` सुविधा को समीक्षाधीन पर सेट करता है; `DECLINE` अस्वीकृत करता है।
नो मैच कार्रवाई	`DATABASE_VALIDATION_DOCUMENT_SUPERSEDED`	नो मैच कार्रवाई सेटिंग साझा करता है — कोई अलग नियंत्रण नहीं है। रजिस्ट्री ने सबमिट किए गए विवरण का खंडन किया, इसलिए कोई संगठन जो नो-मैच पर अस्वीकृत करता है, वह पुराने क्रेडेंशियल पर भी अस्वीकृत करता है।
लागू नहीं कार्रवाई	`DATABASE_VALIDATION_NOT_APPLICABLE`	`NO_ACTION` (डिफ़ॉल्ट) स्थिति को प्रभावित किए बिना चेतावनी रिकॉर्ड करता है; `REVIEW` सुविधा को समीक्षाधीन पर सेट करता है; `DECLINE` अस्वीकृत करता है। यह तब सक्रिय होता है जब दस्तावेज़ की बिल्कुल भी जांच नहीं की जा सकती — इसमें वह पहचानकर्ता नहीं होता जिसके आधार पर कॉन्फ़िगर की गई सेवाएँ क्वेरी करती हैं (उदा. राष्ट्रीय ID संख्या के बिना पासपोर्ट)।

कॉन्फ़िगर की गई कार्रवाई चेतावनी के log_type को भी निर्धारित करती है: DECLINE → error, REVIEW → warning, NO_ACTION → information। मिलान परिणाम स्वयं प्रति-सेवा validation प्रविष्टियों से एकत्रित किया जाता है (कोई भी पूर्ण मिलान → full_match; अन्यथा कोई आंशिक → partial_match; अन्यथा no_match) — 1×1 / 2×2 परिणामों को प्राप्त करने वाले पूर्ण निर्णय तर्क के लिए मिलान के तरीके देखें।

उत्पन्न चेतावनियाँ

Tag	संक्षिप्त विवरण	विवरण
`COULD_NOT_PERFORM_DATABASE_VALIDATION`	डेटाबेस सत्यापन नहीं किया जा सका	किसी भी सेवा ने उपयोगी परिणाम नहीं दिया (`match_type` बना रहता है `null`) — आम तौर पर इसलिए क्योंकि आवश्यक फ़ील्ड अनुपलब्ध या विकृत हैं, या रजिस्ट्री ने कोई त्रुटि लौटाई है। `additional_data` प्रति-सेवा स्किप सारांश (`reason`, `database_validation_errors`, `missing_required_fields_by_service`, `invalid_format_fields_by_service`, `field_reasons_by_service`) रखता है; स्टैंडअलोन API इसके बजाय `{ "validation_errors": [...] }` का उपयोग करता है। यह चेतावनी ट्रिगर होने पर आपसे कोई शुल्क नहीं लिया जाता; डेटा ठीक होने तक सुविधा समीक्षाधीन पर चली जाती है।
`DATABASE_VALIDATION_NOT_APPLICABLE`	इस दस्तावेज़ के लिए डेटाबेस सत्यापन लागू नहीं है	प्रदान किए गए दस्तावेज़ में वह पहचानकर्ता नहीं है जिसकी कॉन्फ़िगर की गई डेटाबेस सेवा(ओं) को आवश्यकता होती है (`match_type` बना रहता है `null`) — उदाहरण के लिए, एक ब्राज़ीलियाई पासपोर्ट में कोई CPF नहीं होता है, इसलिए CPF रजिस्ट्री से पूछताछ नहीं की जा सकती। दस्तावेज़ प्रकार के लिए यह अपेक्षित है और दस्तावेज़ के साथ किसी समस्या का संकेत नहीं देता है। `additional_data` प्रति-सेवा स्किप सारांश रखता है। यह चेतावनी ट्रिगर होने पर आपसे कोई शुल्क नहीं लिया जाता। कार्रवाई कॉन्फ़िगर करने योग्य है (डिफ़ॉल्ट `NO_ACTION`)।
`DATABASE_VALIDATION_PARTIAL_MATCH`	डेटाबेस सत्यापन में आंशिक मिलान	समग्र `match_type` है `partial_match` — कुछ जाँचे गए फ़ील्ड रजिस्ट्री से मेल खाते हैं लेकिन सभी नहीं। कार्रवाई कॉन्फ़िगर करने योग्य है (डिफ़ॉल्ट `NO_ACTION`)।
`DATABASE_VALIDATION_NO_MATCH`	डेटाबेस सत्यापन में कोई मिलान नहीं	समग्र `match_type` है `no_match` — रजिस्ट्री जाँची गई पहचान की पुष्टि नहीं कर सकी। कार्रवाई कॉन्फ़िगर करने योग्य है (वर्कफ़्लो में डिफ़ॉल्ट `REVIEW`, स्टैंडअलोन API पर `DECLINE`)।
`DATABASE_VALIDATION_DOCUMENT_SUPERSEDED`	अधिक्रमित दस्तावेज़ संस्करण	एक सेवा ने `DOCUMENT_SUPERSEDED` लौटाया: रजिस्ट्री ने व्यक्ति की पुष्टि की, लेकिन प्रस्तुत दस्तावेज़ का संस्करण वह नहीं है जो फ़ाइल में है — तब से एक नया संस्करण जारी किया जा चुका है। यह `match_type` से स्वतंत्र रूप से उठाया जाता है, जो `full_match` बना रहता है क्योंकि प्रत्येक व्यक्तिगत फ़ील्ड मेल खाता है, इसलिए अन्यथा यह निष्कर्ष दिखाई नहीं देता। `additional_data` उन सेवाओं के नाम बताता है जिन्होंने इसे रिपोर्ट किया। No Match Action सेटिंग का पालन करता है।

COULD_NOT_PERFORM_DATABASE_VALIDATION दो अलग-अलग स्थितियों को कवर करता है, और चेतावनी का long_description (और, प्रति-सेवा विफलता के लिए, database_validation_errors[].message) अब एक सामान्य वाक्य के बजाय बताता है कि कौन सा लागू हुआ: किसी भी सेवा से पूछताछ किए जाने से पहले जाँचा गया डेटा गायब या विकृत था, या किसी सेवा से पूछताछ की गई थी और उसने कोई उपयोगी परिणाम नहीं दिया। दूसरे मामले में, जब रजिस्ट्री ने उस प्रयास के लिए अपना स्वयं का नैदानिक विवरण रिपोर्ट किया, तो वह विवरण संदेश में शामिल होता है ताकि आपको यह जानने के लिए समर्थन से संपर्क न करना पड़े कि ऐसा क्यों हुआ। अपस्ट्रीम सेवा का नाम कभी भी रिस्पॉन्स में नहीं दिया जाता है।

जब किसी वर्कफ़्लो सत्र में COULD_NOT_PERFORM_DATABASE_VALIDATION या DATABASE_VALIDATION_NOT_APPLICABLE ट्रिगर होता है, तो कंसोल में सत्र विवरण पेज पर अनुपलब्ध डेटा भरे जाने के बाद जाँच स्वचालित रूप से फिर से ट्रिगर हो जाती है — फ़ील्ड को सहेजना सत्यापन को फिर से चलाता है, और सफलता पर चेतावनी हटा दी जाती है। यह तब भी काम करता है जब लागू न होने वाली कार्रवाई ने सत्र को अस्वीकृत कर दिया हो, इसलिए अस्वीकृत सत्र को डेटा ठीक करके सुधारा जा सकता है। DATABASE_VALIDATION_NOT_APPLICABLE के लिए फिर से चलाना तब मदद करता है जब दस्तावेज़ पहचानकर्ता रख सकता है लेकिन इसे पढ़ा नहीं गया था (उदाहरण के लिए, एक निवास कार्ड जिसका राष्ट्रीय आईडी नंबर निकाला नहीं गया था); दस्तावेज़ प्रकार जो कभी भी पहचानकर्ता नहीं रखते हैं (उदाहरण के लिए, राष्ट्रीय आईडी नंबर के बिना पासपोर्ट) चेतावनी बनाए रखते हैं। स्किप की गई सेवाओं के लिए कोई शुल्क नहीं लगाया जाता है; आप केवल तभी भुगतान करते हैं जब कोई सेवा बिल योग्य परिणाम लौटाती है।

उदाहरण

{
  "warnings": [
    {
      "feature": "DATABASE_VALIDATION",
      "risk": "DATABASE_VALIDATION_NO_MATCH",
      "additional_data": null,
      "log_type": "warning",
      "short_description": "Database validation no match",
      "long_description": "The system identified a no match in the database validation, requiring further investigation.",
      "node_id": "feature_db_validation_1"
    }
  ]
}

चेतावनी के प्रकार

प्रत्येक जोखिम को आपके एप्लिकेशन के कॉन्फ़िगरेशन के आधार पर एक गंभीरता सौंपी जाती है। गंभीरताएँ तीन श्रेणियों में आती हैं:

प्रमाणीकरण

सत्यापन

निगरानी

प्लेटफ़ॉर्म

डेटाबेस सत्यापन चेतावनियाँ और स्किप कोड

अवलोकन

कॉन्फ़िगर करने योग्य जोखिम

उत्पन्न चेतावनियाँ

उदाहरण

चेतावनी के प्रकार

संबंधित

​अवलोकन

​कॉन्फ़िगर करने योग्य जोखिम

​उत्पन्न चेतावनियाँ

​उदाहरण

​चेतावनी के प्रकार

​संबंधित

अवलोकन

कॉन्फ़िगर करने योग्य जोखिम

उत्पन्न चेतावनियाँ

उदाहरण

चेतावनी के प्रकार

संबंधित