> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # फ़ोन सत्यापन API (अमेरिका 2): डेटा मिलान > Didit के पहचान इन्फ़्रास्ट्रक्चर से संयुक्त राज्य अमेरिका फ़ोन 2 का प्रामाणिक डेटाबेस सत्यापन। प्रति कॉल $0.25 से, कोई अनुबंध नहीं, कोई न्यूनतम नहीं। यह मोबाइल नेटवर्क ऑपरेटरों के फ़ोन डेटा के विरुद्ध इनपुट डेटा सत्यापित करता है। Didit इस सेवा को `POST /v3/database-validation/` के माध्यम से उपलब्ध कराता है, ताकि आप सबमिट किए गए डेटा को प्रामाणिक स्रोत के विरुद्ध सत्यापित कर सकें और सामान्यीकृत मिलान परिणाम प्राप्त कर सकें। ## कवरेज * **कवरेज:** > 90% * **देश:** संयुक्त राज्य अमेरिका * **सेवा ID:** `usa_states_phone_2` * **डेटा डोमेन:** दूरसंचार * **श्रेणी:** दूरसंचार ## इनपुट | फ़ील्ड | आवश्यक | उदाहरण | | - | -: | - | | `first_name` | हाँ | `John` | | `last_name` | हाँ | `Doe` | | `address.street_1` | हाँ | `123 Sample Street` | | `address.postal_code` | हाँ | `10001` | | `phone` | हाँ | `+15550101000` | | `date_of_birth` | नहीं | `1990-01-01` | | `ssn` | नहीं | `123456789` | | `address.street_2` | नहीं | `Unit 4` | | `address.city` | नहीं | `Sample City` | | `address.region` | नहीं | `Sample State` | | `vendor_data` | नहीं | `user-1234` | * **आवश्यक इनपुट:** `first_name`, `last_name`, `address.street_1`, `address.postal_code`, `phone` * **वैकल्पिक इनपुट:** `date_of_birth`, `ssn`, `address.street_2`, `address.city`, `address.region`, `vendor_data` * **सहमति:** आवश्यक नहीं * **वर्कफ़्लो उपलब्धता:** वर्कफ़्लो में उपलब्ध * **कवरेज:** > 90% * **कीमत:** \$0.25 प्रति सफल क्वेरी ## बॉडी पैरामीटर **issuing\_state** `string` *required* (default: USA) इस डेटाबेस सेवा के लिए ISO 3166-1 alpha-3 देश कोड। उदाहरण: `USA` **services** `string` *required* (default: usa\_states\_phone\_2) इस सेवा ID वाली एक सरणी। सेवा को पिन करने से अनुरोध इसी सटीक डेटाबेस तक सीमित रहता है। उदाहरण: `usa_states_phone_2` **first\_name** `string` *required* (default: John) सत्यापित किया जाने वाला पहला नाम। उदाहरण: `John` **last\_name** `string` *required* (default: Doe) सत्यापित किया जाने वाला अंतिम नाम। उदाहरण: `Doe` **address** `object` *required* (default: \{"street\_1":"123 Sample Street","street\_2":"Unit 4","city":"Sample City","region":"Sample State","postal\_code":"10001","country":"US"}) संरचित आवासीय पता ऑब्जेक्ट। `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"}` **phone** `string` *required* (default: +15550101000) अंतर्राष्ट्रीय प्रारूप में फ़ोन नंबर। उदाहरण: `+15550101000` **date\_of\_birth** `string` `YYYY-MM-DD` प्रारूप में जन्म तिथि। उदाहरण: `1990-01-01` **ssn** `string` `ssn` मान जो इस डेटाबेस सेवा के लिए आवश्यक है। उदाहरण: `123456789` **vendor\_data** `string` (default: user-1234) इस व्यक्ति के लिए आपका स्थायी उपयोगकर्ता संदर्भ, जैसे आपका आंतरिक उपयोगकर्ता ID। Didit इसका उपयोग स्वतंत्र जाँचों को उसी अंतिम उपयोगकर्ता से जोड़ने और डुप्लिकेट-पहचान के शोर को कम करने के लिए करता है। उदाहरण: `user-1234` ## इनपुट नियम और सत्यापन नोट्स * US सोशल सिक्योरिटी नंबर (9 अंक, वैकल्पिक डैश के साथ) * `ssn` को `(?:\d{9}|\d{3}-\d{2}-\d{4})` से मेल खाना होगा। * `ssn` के लिए पूरा 9 अंकों वाला SSN/ITIN भेजें (डैश वैकल्पिक हैं)। US क्रेडिट ब्यूरो और वित्तीय सेवाओं की जाँचों के विपरीत, यह सेवा अंतिम 4 अंकों वाला रूप स्वीकार नहीं करती। * पता-आधारित सेवाओं के लिए, जहाँ संभव हो, एकल `address` स्ट्रिंग के बजाय संरचित पता फ़ील्ड भेजें। * `address.street_1` सड़क का पता है, जिसमें भवन संख्या और सड़क का प्रकार शामिल है। * `address.street_2` अपार्टमेंट, यूनिट, भवन, मंज़िल या अतिरिक्त पता पंक्ति है। इसे केवल तभी भेजें जब आपके पास यह हो। * `address.city` शहर, उपनगर, ज़िला, इलाका या मोहल्ला है। * `address.region` राज्य, प्रांत, क्षेत्र या कस्बा है। * `address.postal_code` पोस्टकोड या डाक कोड है। * पता-आधारित डेटाबेस सेवाओं के लिए कम से कम सड़क का पता और डाक कोड आवश्यक हैं; स्रोत खोज से पहले अस्वीकार किए गए अनुरोधों पर शुल्क नहीं लगता। ## इसे कैसे कॉल करें ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=USA" \ -F "services=usa_states_phone_2" \ -F "vendor_data=user-1234" \ -F "first_name=John" \ -F "last_name=Doe" \ -F 'address={"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}' \ -F "phone=+15550101000" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="USA", services=["usa_states_phone_2"], first_name="John", last_name="Doe", address={"street_1": "123 Sample Street", "street_2": "Unit 4", "city": "Sample City", "region": "Sample State", "postal_code": "10001", "country": "US"}, phone="+15550101000", vendor_data="user-1234", ) print(result) ``` ```javascript Node.js theme={null} import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.databaseValidation.validate({ issuing_state: "USA", services: ["usa_states_phone_2"], first_name: "John", last_name: "Doe", address: { street_1: "123 Sample Street", street_2: "Unit 4", city: "Sample City", region: "Sample State", postal_code: "10001", country: "US" }, phone: "+15550101000", vendor_data: "user-1234", }); console.log(result); ``` ```go Go theme={null} ctx := context.Background() // Reads DIDIT_API_KEY. client := didit.NewClient() result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{ IssuingState: "USA", Services: didit.Some([]string{"usa_states_phone_2"}), FirstName: didit.String("John"), LastName: didit.String("Doe"), Address: didit.Some[any](map[string]any{"street_1": "123 Sample Street", "street_2": "Unit 4", "city": "Sample City", "region": "Sample State", "postal_code": "10001", "country": "US"}), Phone: didit.String("+15550101000"), VendorData: didit.String("user-1234"), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", result) ``` ```java Java theme={null} import java.util.List; import me.didit.Didit; import me.didit.types.DatabaseValidationValidateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder() .issuingState("USA") .services(List.of("usa_states_phone_2")) .firstName("John") .lastName("Doe") .address(DatabaseValidationValidateParams.Address.ofVariant1(DatabaseValidationValidateParams.Address.Variant1.builder() .street1("123 Sample Street") .street2("Unit 4") .city("Sample City") .region("Sample State") .postalCode("10001") .country("US") .build())) .phone("+15550101000") .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'USA', 'services' => ['usa_states_phone_2'], 'first_name' => 'John', 'last_name' => 'Doe', 'address' => ['street_1' => '123 Sample Street', 'street_2' => 'Unit 4', 'city' => 'Sample City', 'region' => 'Sample State', 'postal_code' => '10001', 'country' => 'US'], 'phone' => '+15550101000', 'vendor_data' => 'user-1234', ]); print_r($result->toArray()); ``` ```ruby Ruby theme={null} require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.database_validation.validate( issuing_state: "USA", services: ["usa_states_phone_2"], first_name: "John", last_name: "Doe", address: { street_1: "123 Sample Street", street_2: "Unit 4", city: "Sample City", region: "Sample State", postal_code: "10001", country: "US" }, phone: "+15550101000", vendor_data: "user-1234" ) puts result.to_h ``` ```csharp .NET theme={null} using System; using System.Collections.Generic; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams { IssuingState = "USA", Services = new string[] { "usa_states_phone_2" }, FirstName = "John", LastName = "Doe", Address = new Dictionary { ["street_1"] = "123 Sample Street", ["street_2"] = "Unit 4", ["city"] = "Sample City", ["region"] = "Sample State", ["postal_code"] = "10001", ["country"] = "US" }, Phone = "+15550101000", VendorData = "user-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` हर सफल कॉल HTTP `200` लौटाती है। **`outcome_code`** फ़ील्ड बताता है कि वास्तव में क्या हुआ। उदाहरण के लिए, यह असली बायोमेट्रिक मिलान न होने (`BIOMETRIC_NO_MATCH`) और उस सेल्फ़ी के बीच अंतर बताता है जिसे पढ़ा नहीं जा सका (`BIOMETRIC_IMAGE_UNUSABLE`)। दिखाया गया `status` डिफ़ॉल्ट सुविधा स्थिति है। आपकी कॉन्फ़िगर की गई [Partial Match / No Match कार्रवाइयाँ](https://docs.didit.me/hi/core-technology/database-validation/database-validation-warnings.md) इसे बदल सकती हैं। **`MATCH`**: रजिस्ट्री ने पहचान की पुष्टि की और जाँचा गया हर फ़ील्ड मेल खाया। ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "USA", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "usa_states_phone_2", "service_name": "United States of America - United States Phone 2", "source_data": { "address": "123 Sample Street", "date_of_birth": "1990-01-01", "first_name": "John", "last_name": "Doe" }, "validation": { "address": "full_match", "full_name": "full_match" } } ] } ``` **`PARTIAL_MATCH`**: इस सेवा द्वारा तुलना किए जाने वाले एक या अधिक फ़ील्ड पूरी तरह मेल नहीं खाए। इस उदाहरण में `full_name` मेल नहीं खाया, जबकि `address` मेल खाया। ```json 200 OK — PARTIAL_MATCH theme={null} { "request_id": "req_01H…", "status": "In Review", "issuing_state": "USA", "match_type": "partial_match", "validations": [ { "outcome_code": "PARTIAL_MATCH", "service_id": "usa_states_phone_2", "service_name": "United States of America - United States Phone 2", "source_data": { "address": "123 Sample Street", "date_of_birth": "1990-01-01", "first_name": "John", "last_name": "Doe" }, "validation": { "address": "full_match", "full_name": "no_match" } } ] } ``` **`NO_MATCH`**: रजिस्ट्री ने भेजे गए डेटा के लिए कोई मिलान नहीं लौटाया। ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "USA", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "usa_states_phone_2", "service_name": "United States of America - United States Phone 2", "source_data": { "address": "NO_MATCH", "full_name": "NO_MATCH" }, "validation": { "address": "no_match", "full_name": "no_match" } } ] } ``` ## लौटाया गया डेटा `source_data` में दिखने वाले सटीक फ़ील्ड इस बात पर निर्भर करते हैं कि रजिस्ट्री क्या लौटाती है। `usa_states_phone_2` का जनरेट किया गया उदाहरण फ़िलहाल इस सामान्यीकृत संरचना का दस्तावेज़ीकरण करता है: * `address` * `date_of_birth` * `first_name` * `last_name` ## मूल्य निर्धारण और SLA United States of America - United States Phone 2 क्वेरियों के लिए तभी शुल्क लिया जाता है जब Didit को सत्यापन स्रोत से निर्णायक परिणाम मिलता है। * **प्रति कॉल कीमत:** \$0.25 USD। * **बिलिंग:** प्रति सफल क्वेरी। जब रजिस्ट्री तक पहुँच न हो, जब आवश्यक फ़ील्ड गायब हों, या जब अनुरोध स्रोत तक पहुँचने से पहले अस्वीकार हो जाए, तब आपसे शुल्क नहीं लिया जाता। * **लेटेंसी:** आमतौर पर p95 \< 2 s। * **उपलब्धता:** Didit की ओर से प्रति तिमाही 99.9%। डाउनस्ट्रीम स्रोत की उपलब्धता देश और डेटासेट के अनुसार अलग होती है। ## आगे पढ़ें * [United States डेटाबेस सत्यापन अवलोकन](https://docs.didit.me/api-reference/database-validation/united-states.md) * [डेटाबेस सत्यापन अवलोकन](https://docs.didit.me/hi/core-technology/database-validation/overview.md) * [परिणाम कोड](https://docs.didit.me/hi/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.