> ## 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

> Didit के पहचान इंफ्रास्ट्रक्चर के ज़रिए वैश्विक पहचान-नेटवर्क लुकअप। प्रति कॉल $0.20 से शुरू, कोई अनुबंध या न्यूनतम शर्त नहीं।

यह ईमेल और/या फ़ोन नंबर से व्यक्तियों (नाम, जन्म तिथि, पते, फ़ोन नंबर, ईमेल और राष्ट्रीय पहचान संख्याएँ) की पहचान करता है और एक वैश्विक जोखिम-अंतर्दृष्टि नेटवर्क के माध्यम से नाम-मिलान स्कोर लौटाता है। हर अनुरोध पर शुल्क लिया जाता है। Didit इस सेवा को `POST /v3/database-validation/` के माध्यम से उपलब्ध कराता है, ताकि आप सबमिट किए गए डेटा की जुड़े हुए पहचान नेटवर्क से जाँच कर सकें और सामान्यीकृत मिलान परिणाम प्राप्त कर सकें। यह एक तृतीय-पक्ष समृद्धि नेटवर्क है, कोई प्रामाणिक सरकारी रजिस्ट्री नहीं है। इसके परिणामों को प्राथमिक-स्रोत सत्यापन के रूप में प्रस्तुत न करें।

## कवरेज

* **कवरेज:** 50+ बाज़ार
* **देश:** वैश्विक
* **सेवा ID:** `glb_identity_enrichment`
* **डेटा डोमेन:** पहचान
* **श्रेणी:** IdentityEnrichment

## इनपुट

| फ़ील्ड | आवश्यक | उदाहरण |
| - | -: | - |
| `email` | नहीं | `john.doe@example.com` |
| `phone` | नहीं | `+15550101000` |
| `first_name` | नहीं | `John` |
| `last_name` | नहीं | `Doe` |
| `full_name` | नहीं | `John Doe` |
| `country_of_residence` | नहीं | `US` |
| `vendor_data` | नहीं | `user-1234` |

* **आवश्यक इनपुट:** —
* **वैकल्पिक इनपुट:** `email`, `phone`, `first_name`, `last_name`, `full_name`, `country_of_residence`, `vendor_data`
* **सहमति:** आवश्यक
* **वर्कफ़्लो उपलब्धता:** केवल स्टैंडअलोन API
* **कवरेज:** 50+ बाज़ार
* **मूल्य:** प्रति सफल क्वेरी \$0.20

यह सेवा डेटाबेस सत्यापन चरण के रूप में वर्कफ़्लो के भीतर उपलब्ध नहीं है। यह इस बात को सीमित करता है कि जाँच कहाँ चलती है, न कि आप उसे क्या भेज सकते हैं। इसे स्टैंडअलोन API पर कॉल करें, जहाँ आप इनपुट सीधे प्रदान करते हैं।

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

**issuing\_state** `string` *required* (default: GLB)

इस डेटाबेस सेवा के लिए ISO 3166-1 alpha-3 देश कोड।

उदाहरण: `GLB`

**services** `string` *required* (default: glb\_identity\_enrichment)

इस सेवा ID वाला एक ऐरे। सेवा को पिन करने से अनुरोध इसी सटीक डेटाबेस तक सीमित रहता है।

उदाहरण: `glb_identity_enrichment`

**consent** `boolean` *required* (default: true)

इस सेवा के लिए अंतिम उपयोगकर्ता की स्पष्ट सहमति।

उदाहरण: `true`

**email** `string` (default: [john.doe@example.com](mailto:john.doe@example.com))

ईमेल पता।

उदाहरण: `john.doe@example.com`

**phone** `string` (default: +15550101000)

अंतरराष्ट्रीय प्रारूप में फ़ोन नंबर।

उदाहरण: `+15550101000`

**first\_name** `string` (default: John)

सत्यापित किया जाने वाला पहला नाम।

उदाहरण: `John`

**last\_name** `string` (default: Doe)

सत्यापित किया जाने वाला उपनाम।

उदाहरण: `Doe`

**full\_name** `string`

सत्यापित किया जाने वाला पूरा कानूनी नाम।

उदाहरण: `John Doe`

**country\_of\_residence** `string` (default: US)

वैकल्पिक ISO 3166-1 alpha-2 निवास-देश कोड। इसका उपयोग केवल पहचान लुकअप को केंद्रित करने के लिए होता है।

उदाहरण: `US`

**vendor\_data** `string` (default: user-1234)

इस व्यक्ति के लिए आपका स्थिर उपयोगकर्ता संदर्भ, जैसे आपकी आंतरिक उपयोगकर्ता ID। Didit इसका उपयोग स्टैंडअलोन जाँचों को उसी अंतिम उपयोगकर्ता से जोड़ने और डुप्लिकेट पहचान से होने वाले शोर को कम करने के लिए करता है।

उदाहरण: `user-1234`

## इनपुट नियम और सत्यापन टिप्पणियाँ

* `email` या `phone` में से कम से कम एक दें, क्योंकि ये लुकअप कुंजियाँ हैं। जिस अनुरोध में दोनों में से कोई भी नहीं है, वह एनरिचमेंट लुकअप नहीं कर सकता और उसे स्रोत लुकअप से पहले ही अस्वीकार कर दिया जाता है (शुल्क नहीं लिया जाता)।
* जब भी आपके पास नाम हो, उसे जोड़ें, क्योंकि स्रोत लुकअप को उसी के आधार पर स्कोर करता है। `first_name` और `last_name` भेजें, क्योंकि रिस्पॉन्स का `validation` मैप इन्हीं फ़ील्ड की तुलना करता है। जो अनुरोध केवल `full_name` भेजता है, उसे स्रोत फिर भी स्कोर करता है, लेकिन उसका `validation` खाली और शीर्ष-स्तरीय `match_type` null आता है।
* `country_of_residence` एक ISO 3166-1 alpha-2 कोड है, जिसका उपयोग लुकअप को केंद्रित करने के लिए होता है।
* हर पूरा किया गया लुकअप शुल्क योग्य है, जिसमें वह लुकअप भी शामिल है जिसमें बिल्कुल कोई व्यक्ति नहीं मिलता (`persons_found: 0`)। केवल वह अनुरोध निःशुल्क है जो लुकअप से पहले अस्वीकार हो जाता है, यानी जिसमें न `email` दिया गया है और न `phone`।

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

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=GLB" \
  -F "services=glb_identity_enrichment" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "email=john.doe@example.com" \
  -F "phone=+15550101000" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "country_of_residence=US"
```

```python Python theme={null}
from didit import Didit

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="GLB",
    services=["glb_identity_enrichment"],
    consent=True,
    first_name="John",
    last_name="Doe",
    phone="+15550101000",
    email="john.doe@example.com",
    country_of_residence="US",
    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: "GLB",
  services: ["glb_identity_enrichment"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  phone: "+15550101000",
  email: "john.doe@example.com",
  country_of_residence: "US",
  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:       "GLB",
	Services:           didit.Some([]string{"glb_identity_enrichment"}),
	Consent:            didit.Bool(true),
	FirstName:          didit.String("John"),
	LastName:           didit.String("Doe"),
	Phone:              didit.String("+15550101000"),
	Email:              didit.String("john.doe@example.com"),
	CountryOfResidence: didit.String("US"),
	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("GLB")
        .services(List.of("glb_identity_enrichment"))
        .consent(true)
        .firstName("John")
        .lastName("Doe")
        .phone("+15550101000")
        .email("john.doe@example.com")
        .countryOfResidence("US")
        .vendorData("user-1234")
        .build());
System.out.println(result);
```

```php PHP theme={null}
<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

$result = $didit->databaseValidation->validate([
    'issuing_state' => 'GLB',
    'services' => ['glb_identity_enrichment'],
    'consent' => true,
    'first_name' => 'John',
    'last_name' => 'Doe',
    'phone' => '+15550101000',
    'email' => 'john.doe@example.com',
    'country_of_residence' => 'US',
    '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: "GLB",
  services: ["glb_identity_enrichment"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  phone: "+15550101000",
  email: "john.doe@example.com",
  country_of_residence: "US",
  vendor_data: "user-1234"
)
puts result.to_h
```

```csharp .NET theme={null}
using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams
{
    IssuingState = "GLB",
    Services = new string[] { "glb_identity_enrichment" },
    Consent = true,
    FirstName = "John",
    LastName = "Doe",
    Phone = "+15550101000",
    Email = "john.doe@example.com",
    CountryOfResidence = "US",
    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": "GLB",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "glb_identity_enrichment",
      "service_name": "Global - Identity Enrichment",
      "source_data": {
        "first_name": "John",
        "last_name": "Doe",
        "persons_found": 1
      },
      "validation": {
        "full_name": "full_match"
      }
    }
  ]
}
```

**`PARTIAL_MATCH`**: ईमेल या फ़ोन नंबर से एक व्यक्ति की पहचान हुई, लेकिन सर्वश्रेष्ठ मिलान वाले व्यक्ति का नाम आपके भेजे गए नाम से केवल आंशिक रूप से मेल खाता है।

```json 200 OK — PARTIAL_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "GLB",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "glb_identity_enrichment",
      "service_name": "Global - Identity Enrichment",
      "source_data": {
        "first_name": "John",
        "last_name": "Dow",
        "persons_found": 1
      },
      "validation": {
        "full_name": "partial_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: ईमेल या फ़ोन नंबर से एक व्यक्ति की पहचान हुई, लेकिन सर्वश्रेष्ठ मिलान वाले व्यक्ति का नाम आपके भेजे गए नाम से मेल नहीं खाता।

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "GLB",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "glb_identity_enrichment",
      "service_name": "Global - Identity Enrichment",
      "source_data": {
        "first_name": "Jane",
        "last_name": "Roe",
        "persons_found": 1
      },
      "validation": {
        "full_name": "no_match"
      }
    }
  ]
}
```

**`INCONCLUSIVE`**: ईमेल या फ़ोन नंबर से एक व्यक्ति की पहचान हुई, लेकिन कोई नाम स्कोर नहीं मिला। उदाहरण के लिए, ऐसा तब होता है जब अनुरोध में कोई नाम नहीं था। कुछ भी पुष्ट नहीं किया जाता, इसलिए `validation` खाली है, `match_type` null है, और जाँच समीक्षा के लिए भेजी जाती है। स्कोर वाला परिणाम पाने के लिए `first_name` + `last_name` भेजें। `validation` की तुलना इन्हीं फ़ील्ड को पढ़ती है। केवल `full_name` वाले अनुरोध को स्कोर वाला `outcome_code` मिलता है, लेकिन `validation` फिर भी खाली रहता है।

```json 200 OK — INCONCLUSIVE theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "GLB",
  "match_type": null,
  "validations": [
    {
      "outcome_code": "INCONCLUSIVE",
      "service_id": "glb_identity_enrichment",
      "service_name": "Global - Identity Enrichment",
      "source_data": {
        "persons_found": 1
      },
      "validation": {}
    }
  ]
}
```

**`DOCUMENT_NOT_FOUND`**: ईमेल या फ़ोन नंबर से कोई भी व्यक्ति नहीं मिला (`persons_found: 0`)। तुलना के लिए कोई नाम नहीं है, इसलिए `validation` खाली है और `match_type` null है। यह परिणाम एक निश्चित नकारात्मक परिणाम है, और यह आपकी No Match कार्रवाई के अनुसार चलता है। इस लुकअप का शुल्क फिर भी लिया जाता है।

```json 200 OK — DOCUMENT_NOT_FOUND theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "GLB",
  "match_type": null,
  "validations": [
    {
      "outcome_code": "DOCUMENT_NOT_FOUND",
      "service_id": "glb_identity_enrichment",
      "service_name": "Global - Identity Enrichment",
      "source_data": {
        "persons_found": 0
      },
      "validation": {}
    }
  ]
}
```

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

`source_data` में दिखने वाले सटीक फ़ील्ड इस पर निर्भर करते हैं कि रजिस्ट्री क्या लौटाती है। `glb_identity_enrichment` के लिए जनरेट किया गया उदाहरण वर्तमान में इस सामान्यीकृत संरचना का दस्तावेज़ीकरण करता है:

* `first_name`
* `last_name`
* `persons_found`

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

Global - Identity Enrichment क्वेरी का शुल्क केवल तभी लिया जाता है जब Didit को सत्यापन स्रोत से एक निश्चित परिणाम मिलता है।

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

## आगे पढ़ें

* [ग्लोबल डेटाबेस सत्यापन अवलोकन](https://docs.didit.me/hi/getting-started/database-validation-pricing.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.