> ## 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 के साथ दक्षिण अफ्रीका के प्रामाणिक डेटाबेस से शरणार्थी फ़ाइल सत्यापन। प्रति कॉल $1.28 से, कोई अनुबंध या न्यूनतम शर्त नहीं।

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

## कवरेज

* **कवरेज:** —
* **देश:** दक्षिण अफ़्रीका
* **सेवा ID:** `zaf_refugee`
* **डेटा डोमेन:** पहचान
* **श्रेणी:** सरकार

## इनपुट

| फ़ील्ड | आवश्यक | उदाहरण |
| - | -: | - |
| `refugee_file_number` | हाँ | `RF123456` |
| `phone_number` | नहीं | `+15550101000` |
| `email` | नहीं | `john.doe@example.com` |
| `vendor_data` | नहीं | `user-1234` |

* **आवश्यक इनपुट:** `refugee_file_number`
* **वैकल्पिक इनपुट:** `phone_number`, `email`, `vendor_data`
* **सहमति:** आवश्यक नहीं
* **वर्कफ़्लो में उपलब्धता:** फ़ील्ड मैपिंग के साथ वर्कफ़्लो में उपलब्ध
* **कवरेज:** —
* **कीमत:** प्रति सफल क्वेरी \$1.28

वर्कफ़्लो में, `refugee_file_number` किसी पहचान दस्तावेज़ पर नहीं छपा होता, इसलिए कोई चरण इसे अपने आप उत्पन्न नहीं करता। इसे प्रश्नावली के उत्तर, Document AI के निष्कर्षण फ़ील्ड, या सत्र बनाते समय आपके द्वारा भेजे गए मान से एकत्र करें, और डेटाबेस सत्यापन चरण पर इसकी मैपिंग करें। मैपिंग होने तक वर्कफ़्लो एडिटर इस सेवा को अक्षम दिखाता है और गायब इनपुट का नाम बताता है। रन के समय गायब इनपुट का अर्थ है कि जाँच किसी भी क्वेरी से पहले छोड़ दी जाती है, इसलिए जिस डेटाबेस से पूछा ही नहीं जा सका, उसके लिए आपसे कभी शुल्क नहीं लिया जाता।

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

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

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

उदाहरण: `ZAF`

**services** `string` *required* (default: zaf\_refugee)

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

उदाहरण: `zaf_refugee`

**refugee\_file\_number** `string` *required* (default: RF123456)

इस डेटाबेस सेवा के लिए आवश्यक `refugee_file_number` मान।

उदाहरण: `RF123456`

**phone\_number** `string`

इस डेटाबेस सेवा के लिए आवश्यक `phone_number` मान।

उदाहरण: `+15550101000`

**email** `string`

ईमेल पता।

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

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

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

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

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

* ऊपर सूचीबद्ध फ़ील्ड को ठीक वैसे ही भेजें जैसे उन्हें उपयोगकर्ता या दस्तावेज़ से लिया गया है।
* Didit डेटाबेस को कॉल करने से पहले आवश्यक फ़ील्ड सत्यापित करता है। स्रोत खोज से पहले अस्वीकार किए गए अनुरोधों पर शुल्क नहीं लिया जाता।

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

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_refugee" \
  -F "vendor_data=user-1234" \
  -F "refugee_file_number=RF123456"
```

हर सफल कॉल HTTP `200` लौटाती है। **`outcome_code`** फ़ील्ड आपको बताता है कि वास्तव में क्या हुआ, जैसे कि वास्तविक बायोमेट्रिक असंगति (`BIOMETRIC_NO_MATCH`) और ऐसे सेल्फ़ी के बीच अंतर, जिसे पढ़ा नहीं जा सका (`BIOMETRIC_IMAGE_UNUSABLE`)। दिखाया गया `status` सुविधा की डिफ़ॉल्ट स्थिति है। आपकी कॉन्फ़िगर की गई [आंशिक मिलान / कोई मिलान नहीं कार्रवाइयाँ](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": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: सबमिट किए गए डेटा के लिए रजिस्ट्री से कोई मिलान नहीं मिला।

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_refugee",
      "service_name": "South Africa - Refugee File Verification",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

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

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

* रजिस्ट्री के रिस्पॉन्स के अनुसार बदलता है।

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

दक्षिण अफ़्रीका - शरणार्थी फ़ाइल सत्यापन की क्वेरी का शुल्क केवल तब लिया जाता है जब Didit को सत्यापन स्रोत से निर्णायक परिणाम मिलता है।

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

## आगे पढ़ें

* [दक्षिण अफ़्रीका डेटाबेस सत्यापन अवलोकन](https://docs.didit.me/api-reference/database-validation/south-africa.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.