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

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

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

## التغطية

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

## المدخلات

| الحقل | مطلوب | مثال |
| - | -: | - |
| `first_name` | نعم | `John` |
| `last_name` | نعم | `Doe` |
| `date_of_birth` | نعم | `1990-01-01` |
| `birth_registration_number` | نعم | `SAMPLE-BIRTH-12345` |
| `birth_registration_date` | نعم | `1990-01-01` |
| `birth_registration_state` | نعم | `Sample State` |
| `middle_name` | لا | `Demo` |
| `vendor_data` | لا | `user-1234` |

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

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

## معاملات الجسم

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

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

مثال: `AUS`

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

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

مثال: `aus_birth_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`

**birth\_registration\_number** `string` *required* (default: SAMPLE-BIRTH-12345)

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

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

**birth\_registration\_date** `string` *required* (default: 1990-01-01)

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

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

**birth\_registration\_state** `string` *required* (default: Sample State)

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

مثال: `Sample State`

**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_birth_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 "birth_registration_number=SAMPLE-BIRTH-12345" \
  -F "birth_registration_date=1990-01-01" \
  -F "birth_registration_state=Sample State"
```

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

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="AUS",
    services=["aus_birth_certificate"],
    consent=True,
    first_name="John",
    last_name="Doe",
    date_of_birth="1990-01-01",
    birth_registration_number="SAMPLE-BIRTH-12345",
    birth_registration_date="1990-01-01",
    birth_registration_state="Sample State",
    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_birth_certificate"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  birth_registration_number: "SAMPLE-BIRTH-12345",
  birth_registration_date: "1990-01-01",
  birth_registration_state: "Sample State",
  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_birth_certificate"}),
	Consent:                 didit.Bool(true),
	FirstName:               didit.String("John"),
	LastName:                didit.String("Doe"),
	DateOfBirth:             didit.String("1990-01-01"),
	BirthRegistrationNumber: didit.String("SAMPLE-BIRTH-12345"),
	BirthRegistrationDate:   didit.String("1990-01-01"),
	BirthRegistrationState:  didit.String("Sample State"),
	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_birth_certificate"))
        .consent(true)
        .firstName("John")
        .lastName("Doe")
        .dateOfBirth(LocalDate.parse("1990-01-01"))
        .birthRegistrationNumber("SAMPLE-BIRTH-12345")
        .birthRegistrationDate(LocalDate.parse("1990-01-01"))
        .birthRegistrationState("Sample State")
        .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_birth_certificate'],
    'consent' => true,
    'first_name' => 'John',
    'last_name' => 'Doe',
    'date_of_birth' => '1990-01-01',
    'birth_registration_number' => 'SAMPLE-BIRTH-12345',
    'birth_registration_date' => '1990-01-01',
    'birth_registration_state' => 'Sample State',
    '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_birth_certificate"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  date_of_birth: "1990-01-01",
  birth_registration_number: "SAMPLE-BIRTH-12345",
  birth_registration_date: "1990-01-01",
  birth_registration_state: "Sample State",
  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_birth_certificate" },
    Consent = true,
    FirstName = "John",
    LastName = "Doe",
    DateOfBirth = "1990-01-01",
    BirthRegistrationNumber = "SAMPLE-BIRTH-12345",
    BirthRegistrationDate = "1990-01-01",
    BirthRegistrationState = "Sample State",
    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/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_birth_certificate",
      "service_name": "Australia - DVS - Birth 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_birth_certificate",
      "service_name": "Australia - DVS - Birth 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_birth_certificate",
      "service_name": "Australia - DVS - Birth 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_birth_certificate` حالياً هذا الشكل الموحّد:

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

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

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

* **السعر لكل استدعاء:** \$0.75 USD.
* **الفوترة:** لكل استعلام ناجح. لا يُحتسب عليك أي مبلغ عندما يتعذر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
* **زمن الاستجابة:** النموذجي p95 أقل من 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.