मुख्य सामग्री पर जाएं
POST
यह सेवा फ़िनलैंड के पहचान कार्ड जारी करने वाली आधिकारिक एजेंसी के रिकॉर्ड से इनपुट डेटा का सत्यापन करती है। Didit इस सेवा को POST /v3/database-validation/ के माध्यम से उपलब्ध कराता है, ताकि आप सबमिट किए गए डेटा को आधिकारिक स्रोत से मिलाकर सामान्यीकृत मिलान परिणाम प्राप्त कर सकें।

कवरेज

  • कवरेज: ~ 100%
  • देश: फ़िनलैंड
  • सेवा ID: fin_national_id
  • डेटा डोमेन: पहचान
  • श्रेणी: NationalIDRegistry

इनपुट

  • आवश्यक इनपुट: first_name, last_name, date_of_birth, national_id
  • वैकल्पिक इनपुट: address.street_1, address.street_2, address.city, address.region, address.postal_code, vendor_data
  • सहमति: आवश्यक
  • वर्कफ़्लो में उपलब्धता: वर्कफ़्लो में उपलब्ध
  • कवरेज: ~ 100%
  • कीमत: $3.50 प्रति सफल क्वेरी
इस सेवा द्वारा स्वीकार किए जाने वाले हर दस्तावेज़ में वह पहचानकर्ता नहीं होता जिससे क्वेरी की जाती है। जब दस्तावेज़ से पहचानकर्ता निकाला नहीं जाता, तो जाँच लागू नहीं के रूप में दर्ज होती है - कोई डेटाबेस क्वेरी नहीं होती और आपसे शुल्क नहीं लिया जाता - और कुछ देशों में वास्तविक उपयोगकर्ताओं का बड़ा हिस्सा इसी स्थिति में आता है। ऐसे उपयोगकर्ताओं को कवर करने के लिए, पहचानकर्ता को किसी प्रश्नावली के उत्तर, Document AI एक्सट्रैक्शन फ़ील्ड, या सत्र बनाते समय भेजे गए मान से भी एकत्र करें, और उसे डेटाबेस सत्यापन चरण पर मैप करें।

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

string
डिफ़ॉल्ट:"FIN"
आवश्यक
इस डेटाबेस सेवा के लिए ISO 3166-1 alpha-3 देश कोड।उदाहरण: FIN
string
डिफ़ॉल्ट:"fin_national_id"
आवश्यक
इस सेवा ID को शामिल करने वाला एरे। सेवा को पिन करने से अनुरोध इसी सटीक डेटाबेस तक सीमित रहता है।उदाहरण: fin_national_id
इस सेवा के लिए अंतिम उपयोगकर्ता की स्पष्ट सहमति।उदाहरण: true
string
डिफ़ॉल्ट:"John"
आवश्यक
सत्यापित किया जाने वाला दिया गया नाम।उदाहरण: John
string
डिफ़ॉल्ट:"Doe"
आवश्यक
सत्यापित किया जाने वाला पारिवारिक नाम।उदाहरण: Doe
string
डिफ़ॉल्ट:"1990-01-01"
आवश्यक
YYYY-MM-DD प्रारूप में जन्म तिथि।उदाहरण: 1990-01-01
string
डिफ़ॉल्ट:"010190-123A"
आवश्यक
इस सेवा के लिए राष्ट्रीय पहचान संख्या।उदाहरण: 010190-123A
object
संरचित निवास पता ऑब्जेक्ट। street_1, street_2, city, region, postal_code और country का उपयोग करें। पते की पूरी पुरानी स्ट्रिंग अब भी स्वीकार की जाती है, लेकिन इसकी अनुशंसा नहीं की जाती।उदाहरण: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
डिफ़ॉल्ट:"user-1234"
इस व्यक्ति के लिए आपका स्थिर उपयोगकर्ता संदर्भ, जैसे आपका आंतरिक उपयोगकर्ता ID। Didit इसका उपयोग स्वतंत्र जाँचों को उसी अंतिम उपयोगकर्ता से जोड़ने और डुप्लिकेट-पहचान के शोर को कम करने के लिए करता है।उदाहरण: user-1234

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

  • इस सेवा के लिए address वैकल्पिक है। आप एक पूरी address स्ट्रिंग भेज सकते हैं, और संभव होने पर Didit उसे संरचित पता तत्वों में विभाजित कर देगा, या आप संरचित फ़ील्ड स्पष्ट रूप से भेज सकते हैं।
  • national_id को (?:\d{6}[-+A]\d{3}[0-9A-Z]|\d{6}\d{3}[0-9A-Z]) से मेल खाना चाहिए।
  • पता-आधारित डेटाबेस सेवाओं के लिए, संभव हो तो एकल address स्ट्रिंग के बजाय संरचित पता फ़ील्ड भेजें।
  • address.street_1 सड़क का पता है, जिसमें मकान नंबर और सड़क का प्रकार शामिल है।
  • address.street_2 अपार्टमेंट, यूनिट, भवन, मंज़िल या कोई अतिरिक्त पता पंक्ति है। इसे केवल तभी भेजें जब आपके पास यह हो।
  • address.city शहर, उपनगर, ज़िला, इलाका या मोहल्ला है।
  • address.region राज्य, प्रांत, क्षेत्र या कस्बा है।
  • address.postal_code पिनकोड या डाक कोड है।
  • पता-आधारित डेटाबेस सेवाओं के लिए कम से कम सड़क का पता और पोस्टल कोड आवश्यक है; स्रोत में खोज किए जाने से पहले अस्वीकार किए गए अनुरोधों पर शुल्क नहीं लिया जाता।

How to call it

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

source_data में कौन-से सटीक फ़ील्ड दिखेंगे, यह इस बात पर निर्भर करता है कि रजिस्ट्री क्या लौटाती है। fin_national_id के लिए बनाया गया उदाहरण फ़िलहाल यह सामान्यीकृत संरचना दर्शाता है:
  • address
  • date_of_birth
  • first_name
  • identification_number
  • last_name

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

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

आगे पढ़ें

अंतिम संशोधन 7 नवंबर 2026