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

# التحقق من شهادة الجنسية في أستراليا (DVS) API

> التحقق من شهادة الجنسية الأسترالية عبر قاعدة البيانات الرسمية باستخدام Didit. الدفع لكل استدعاء بدءاً من $0.75، دون عقود أو حد أدنى.

يتحقق من بيانات الإدخال مقابل خدمة التحقق من المستندات (DVS). تتيح لك Didit الوصول إلى هذه الخدمة عبر `POST /v3/database-validation/` للتحقق من البيانات المُرسَلة مقابل المصدر الرسمي والحصول على نتائج مطابقة موحّدة.

## التغطية

* **التغطية:** 100%\*
* **الدولة:** أستراليا
* **معرّف الخدمة:** `aus_citizenship_certificate`
* **نطاق البيانات:** الهوية
* **الفئة:** المواطنة

## المدخلات

| الحقل | مطلوب | مثال |
| - | -: | - |
| `first_name` | نعم | `John` |
| `last_name` | نعم | `Doe` |
| `date_of_birth` | نعم | `1990-01-01` |
| `citizenship_certificate_number` | نعم | `SAMPLE-CERT-12345` |
| `middle_name` | لا | `Demo` |
| `vendor_data` | لا | `user-1234` |

* **المدخلات المطلوبة:** `first_name` و`last_name` و`date_of_birth` و`citizenship_certificate_number`
* **المدخلات الاختيارية:** `middle_name` و`vendor_data`
* **الموافقة:** مطلوبة
* **توفر سير العمل:** متاح في سير العمل مع ربط الحقول
* **التغطية:** 100%\*
* **السعر:** \$0.75 لكل استعلام ناجح

في سير العمل، لا يُطبع `citizenship_certificate_number` على وثيقة الهوية، لذلك لا تُنتجه أي خطوة بمفردها. اجمعه من إجابة في الاستبيان أو من حقل مستخرج عبر Document AI، أو من قيمة ترسلها عند إنشاء الجلسة، ثم اربطه بخطوة التحقق من قواعد البيانات (Database Validation). إلى أن يُربط هذا الحقل، يعرض محرر سير العمل هذه الخدمة معطّلة ويذكر المدخل الناقص. وعند التشغيل، يعني المدخل الناقص أن الفحص يُتخطى قبل أي استعلام، فلا تُحتسب عليك تكلفة قاعدة بيانات لم يكن بالإمكان الاستعلام منها.

## معاملات نص الطلب

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

رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.

مثال: `AUS`

**services** `string` *required* (default: aus\_citizenship\_certificate)

مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات هذه تحديداً.

مثال: `aus_citizenship_certificate`

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

موافقة صريحة من المستخدم النهائي على هذه الخدمة.

مثال: `true`

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

الاسم الأول المراد التحقق منه.

مثال: `John`

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

اسم العائلة المراد التحقق منه.

مثال: `Doe`

**date\_of\_birth** `string` *required* (default: 1990-01-01)

تاريخ الميلاد بالصيغة `YYYY-MM-DD`.

مثال: `1990-01-01`

**citizenship\_certificate\_number** `string` *required* (default: SAMPLE-CERT-12345)

القيمة `citizenship_certificate_number` المطلوبة من خدمة قاعدة البيانات هذه.

مثال: `SAMPLE-CERT-12345`

**middle\_name** `string`

الاسم الأوسط، عند توفره.

مثال: `Demo`

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

معرّفك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه 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=AUS" \
  -F "services=aus_citizenship_certificate" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "date_of_birth=1990-01-01" \
  -F "citizenship_certificate_number=SAMPLE-CERT-12345"
```

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

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="AUS",
    services=["aus_citizenship_certificate"],
    consent=True,
    first_name="John",
    last_name="Doe",
    date_of_birth="1990-01-01",
    citizenship_certificate_number="SAMPLE-CERT-12345",
    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: "AUS",
  services: ["aus_citizenship_certificate"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  citizenship_certificate_number: "SAMPLE-CERT-12345",
  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:                 "AUS",
	Services:                     didit.Some([]string{"aus_citizenship_certificate"}),
	Consent:                      didit.Bool(true),
	FirstName:                    didit.String("John"),
	LastName:                     didit.String("Doe"),
	DateOfBirth:                  didit.String("1990-01-01"),
	CitizenshipCertificateNumber: didit.String("SAMPLE-CERT-12345"),
	VendorData:                   didit.String("user-1234"),
})
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)
```

```java Java theme={null}
import java.time.LocalDate;
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("AUS")
        .services(List.of("aus_citizenship_certificate"))
        .consent(true)
        .firstName("John")
        .lastName("Doe")
        .dateOfBirth(LocalDate.parse("1990-01-01"))
        .citizenshipCertificateNumber("SAMPLE-CERT-12345")
        .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' => 'AUS',
    'services' => ['aus_citizenship_certificate'],
    'consent' => true,
    'first_name' => 'John',
    'last_name' => 'Doe',
    'date_of_birth' => '1990-01-01',
    'citizenship_certificate_number' => 'SAMPLE-CERT-12345',
    '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: "AUS",
  services: ["aus_citizenship_certificate"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  citizenship_certificate_number: "SAMPLE-CERT-12345",
  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 = "AUS",
    Services = new string[] { "aus_citizenship_certificate" },
    Consent = true,
    FirstName = "John",
    LastName = "Doe",
    DateOfBirth = "1990-01-01",
    CitizenshipCertificateNumber = "SAMPLE-CERT-12345",
    VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
```

يُرجع كل استدعاء ناجح رمز HTTP `200`. يوضح لك الحقل **`outcome_code`** ما الذي حدث فعلاً، فيميّز مثلاً بين عدم تطابق بيومتري حقيقي (`BIOMETRIC_NO_MATCH`) وصورة سيلفي تعذّرت قراءتها (`BIOMETRIC_IMAGE_UNUSABLE`). الحالة `status` المعروضة هي الحالة الافتراضية للميزة، ويمكن أن تتجاوزها [إجراءات المطابقة الجزئية / عدم المطابقة](https://docs.didit.me/ar/core-technology/database-validation/database-validation-warnings.md) التي تضبطها.

**`MATCH`**: أكّد السجل الهوية، وتطابقت كل الحقول المفحوصة.

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "AUS",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "aus_citizenship_certificate",
      "service_name": "Australia - DVS – Citizenship Certificate",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "middle_name": "Demo"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`PARTIAL_MATCH`**: وُجد رقم الهوية، لكن حقلاً شخصياً واحداً أو أكثر (عادةً الاسم أو تاريخ الميلاد) لم يتطابق تماماً.

```json 200 OK — PARTIAL_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "In Review",
  "issuing_state": "AUS",
  "match_type": "partial_match",
  "validations": [
    {
      "outcome_code": "PARTIAL_MATCH",
      "service_id": "aus_citizenship_certificate",
      "service_name": "Australia - DVS – Citizenship Certificate",
      "source_data": {
        "date_of_birth": "1990-01-01",
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe",
        "middle_name": "Demo"
      },
      "validation": {
        "date_of_birth": "full_match",
        "full_name": "no_match",
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: لم يُرجع السجل أي تطابق مع البيانات المُرسَلة.

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "AUS",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "aus_citizenship_certificate",
      "service_name": "Australia - DVS – Citizenship Certificate",
      "source_data": {
        "date_of_birth": "NO_MATCH",
        "full_name": "NO_MATCH",
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "date_of_birth": "no_match",
        "full_name": "no_match",
        "identification_number": "no_match"
      }
    }
  ]
}
```

## البيانات المُرجعة

تعتمد الحقول الدقيقة التي تظهر في `source_data` على ما يُرجعه السجل. يوثّق المثال المُولَّد لـ `aus_citizenship_certificate` حالياً البنية الموحّدة التالية:

* `date_of_birth`
* `first_name`
* `identification_number`
* `last_name`
* `middle_name`

## الأسعار واتفاقيات مستوى الخدمة

تُحتسب استعلامات أستراليا - DVS - شهادة الجنسية فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.

* **السعر لكل استدعاء:** \$0.75 دولار أمريكي.
* **الفوترة:** لكل استعلام ناجح. لا تُحتسب عليك تكلفة عندما يكون السجل غير متاح، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
* **زمن الاستجابة:** المئين 95 النموذجي أقل من 2 ثانية.
* **التوفر:** 99.9% لكل ربع سنة من جهة Didit؛ أما توفر مصدر البيانات الخارجي فيختلف حسب الدولة ومجموعة البيانات.

## متابعة القراءة

* [نظرة عامة على التحقق من قواعد البيانات في أستراليا](https://docs.didit.me/api-reference/database-validation/australia.md)
* [نظرة عامة على التحقق من قواعد البيانات](https://docs.didit.me/ar/core-technology/database-validation/overview.md)
* [رموز النتائج](https://docs.didit.me/ar/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.