मुख्य सामग्री पर जाएं
POST
curl
Didit का Address Validation API पुष्टि करता है कि कोई डाक पता मौजूद है, और उसे सामान्यीकृत रूप में लौटाता है, जिसमें उसकी डिलीवरी लाइनें, घटक और निर्देशांक शामिल होते हैं। जब आपके बैकएंड के पास कोई पता हो और आपको जानना हो कि वह मौजूद है या नहीं, और किस सामान्यीकृत रूप में है, तब POST /v3/address-validation/ का उपयोग करें। Address Validation केवल पते की पुष्टि करता है। यह पते को किसी व्यक्ति से कभी नहीं जोड़ता: verified परिणाम का अर्थ है कि वह स्थान मौजूद है, न कि यह कि वहाँ कोई रहता है।

पता भेजें

इसे address में एक पंक्ति में भेजें, या संरचित फ़ील्ड के रूप में भेजें: address_line_1, और यदि आपके पास हों तो address_line_2, city, region और postal_code। एक ही अनुरोध में दोनों रूप कभी न भेजें। country हमेशा आवश्यक है, ISO 3166-1 alpha-2 या alpha-3 कोड के रूप में।

परिणाम की व्याख्या करें

  • address_validation.status वह उत्तर है जिस पर आपको आगे काम करना चाहिए:
    • verified: पता इमारत तक (या फ़्लैट या PO बॉक्स तक) की पुष्टि हुई।
    • partially_verified: पते की पुष्टि केवल सड़क तक हुई, या डाक संदर्भ डेटा में उस स्थान के लिए उपलब्ध सबसे सटीक स्तर तक।
    • not_verified: केवल क्षेत्र या शहर मेल खाया, या कुछ भी मेल नहीं खाया।
    • unavailable: सत्यापन चल नहीं सका। बाद में पुनः प्रयास करें।
  • address_validation.verification_level सबसे सटीक मेल खाने वाला स्तर है: administrative_area, locality, thoroughfare, premise या delivery_point।
  • address_validation.address और address_validation.formatted_address में सामान्यीकृत पता होता है, जिस प्रकार देश उसे लिखता है।
  • address_validation.latitude और address_validation.longitude मेल खाए पते का स्थान बताते हैं।
  • request_id अनुरोध की पहचान करता है। कोई सत्र नहीं बनता और परिणाम केवल इसी रिस्पॉन्स में लौटाया जाता है, इसलिए जो चाहिए उसे सेव कर लें।
पूर्ण हुए हर अनुरोध के लिए HTTP 200 होता है, unavailable सहित।

वर्कफ़्लो के भीतर Address Validation

यही जाँच पहचान सत्यापन और पते का प्रमाण वर्कफ़्लो चरणों का एक ऐड-ऑन है। चरण की सेटिंग्स में address_validation_enabled चालू करें, और व्यक्ति द्वारा दिया गया पता (पहचान दस्तावेज़ पर छपा हुआ, या पते के प्रमाण पर) उनके अपलोड के पढ़े जाने के बाद एक बार सत्यापित किया जाता है। परिणाम सत्र के निर्णय में उस चरण की प्रविष्टि के address_validation ऑब्जेक्ट के रूप में आता है (id_verifications[] या poa_verifications[])। partially_verified या not_verified पता ADDRESS_NOT_VERIFIED चेतावनी उत्पन्न करता है, जिसकी कार्रवाई उस चरण का address_not_verified_action होती है (डिफ़ॉल्ट रूप से NO_ACTION, जो केवल चेतावनी दर्ज करता है)। unavailable सत्यापन यह चेतावनी कभी उत्पन्न नहीं करता और सत्यापन को कभी नहीं बदलता।

सैंडबॉक्स व्यवहार

सैंडबॉक्स कुंजियाँ अनुरोध को सत्यापित करती हैं और हमेशा एक निर्धारित verified परिणाम लौटाती हैं, जो आपके भेजे गए पते को ही दोहराता है। वे क्रेडिट का उपयोग नहीं करतीं।

बिलिंग

Address Validation API कॉल की लागत प्रति सत्यापित पता $0.10 है। `unavailable` परिणाम के लिए शुल्क नहीं लिया जाता। वर्कफ़्लो में, ऐड-ऑन की लागत प्रति पता $0.10 है, जिसे कोई चरण सत्यापित करता है।

प्राधिकरण

x-api-key
string
header
आवश्यक

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys।

बॉडी

application/json

एक पता: एक पंक्ति में (address) या कम से कम address_line_1 के साथ संरचित फ़ील्ड के रूप में, दोनों कभी नहीं।

country
string
आवश्यक

पते के देश का ISO 3166-1 alpha-2 या alpha-3 कोड।

Maximum string length: 3
उदाहरण:

"US"

address
string

पूरा पता एक पंक्ति में।

Maximum string length: 500
उदाहरण:

"Paseo de la Castellana 259, 28046 Madrid"

address_line_1
string

सड़क और संख्या।

Maximum string length: 255
उदाहरण:

"1600 Amphitheatre Pkwy"

address_line_2
string

अपार्टमेंट, सुइट, फ़्लोर या भवन।

Maximum string length: 255
city
string

शहर या इलाका।

Maximum string length: 128
उदाहरण:

"Mountain View"

region
string

राज्य, प्रांत या क्षेत्र।

Maximum string length: 128
उदाहरण:

"CA"

postal_code
string
Maximum string length: 32
उदाहरण:

"94043"

प्रतिक्रिया

सत्यापन पूरा हुआ। address_validation.status पढ़ें; पूरे किए गए अनुरोध के लिए HTTP हमेशा 200 होता है।

request_id
string<uuid>
आवश्यक

इस अनुरोध का पहचानकर्ता; सहायता टीम को इसका संदर्भ दें। कोई सत्र नहीं बनाया गया है।

address_validation
object
आवश्यक

एक Address Validation का परिणाम: क्या पता मौजूद है, और इसका सामान्यीकृत रूप। यह केवल पते की पुष्टि करता है; यह कभी भी पते को किसी व्यक्ति से नहीं जोड़ता है।

created_at
string<date-time>
आवश्यक
अंतिम संशोधन 7 नवंबर 2026