> ## 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 لكل استدعاء، دون عقود أو حد أدنى.

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

## التغطية

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

## المدخلات

| الحقل | مطلوب | مثال |
| - | -: | - |
| `first_name` | نعم | `John` |
| `last_name` | نعم | `Doe` |
| `first_partner_name` | نعم | `Jamie` |
| `last_partner_name` | نعم | `Example` |
| `marriage_certificate_number` | نعم | `SAMPLE-MARRIAGE-12345` |
| `birth_registration_number` | نعم | `SAMPLE-BIRTH-12345` |
| `birth_registration_state` | نعم | `Sample State` |
| `birth_registration_date` | نعم | `1990-01-01` |
| `vendor_data` | لا | `user-1234` |

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

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

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

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

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

مثال: `AUS`

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

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

مثال: `aus_marriage_certificate`

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

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

مثال: `true`

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

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

مثال: `John`

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

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

مثال: `Doe`

**first\_partner\_name** `string` *required* (default: Jamie)

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

مثال: `Jamie`

**last\_partner\_name** `string` *required* (default: Example)

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

مثال: `Example`

**marriage\_certificate\_number** `string` *required* (default: SAMPLE-MARRIAGE-12345)

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

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

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

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

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

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

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

مثال: `Sample State`

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

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

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

**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_marriage_certificate" \
  -F "vendor_data=user-1234" \
  -F "consent=true" \
  -F "first_name=John" \
  -F "last_name=Doe" \
  -F "first_partner_name=Jamie" \
  -F "last_partner_name=Example" \
  -F "marriage_certificate_number=SAMPLE-MARRIAGE-12345" \
  -F "birth_registration_number=SAMPLE-BIRTH-12345" \
  -F "birth_registration_state=Sample State" \
  -F "birth_registration_date=1990-01-01"
```

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

# Reads DIDIT_API_KEY.
client = Didit()

result = client.database_validation.validate(
    issuing_state="AUS",
    services=["aus_marriage_certificate"],
    consent=True,
    first_name="John",
    last_name="Doe",
    birth_registration_number="SAMPLE-BIRTH-12345",
    birth_registration_date="1990-01-01",
    birth_registration_state="Sample State",
    marriage_certificate_number="SAMPLE-MARRIAGE-12345",
    first_partner_name="Jamie",
    last_partner_name="Example",
    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_marriage_certificate"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  birth_registration_number: "SAMPLE-BIRTH-12345",
  birth_registration_date: "1990-01-01",
  birth_registration_state: "Sample State",
  marriage_certificate_number: "SAMPLE-MARRIAGE-12345",
  first_partner_name: "Jamie",
  last_partner_name: "Example",
  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_marriage_certificate"}),
	Consent:                   didit.Bool(true),
	FirstName:                 didit.String("John"),
	LastName:                  didit.String("Doe"),
	BirthRegistrationNumber:   didit.String("SAMPLE-BIRTH-12345"),
	BirthRegistrationDate:     didit.String("1990-01-01"),
	BirthRegistrationState:    didit.String("Sample State"),
	MarriageCertificateNumber: didit.String("SAMPLE-MARRIAGE-12345"),
	FirstPartnerName:          didit.String("Jamie"),
	LastPartnerName:           didit.String("Example"),
	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_marriage_certificate"))
        .consent(true)
        .firstName("John")
        .lastName("Doe")
        .birthRegistrationNumber("SAMPLE-BIRTH-12345")
        .birthRegistrationDate(LocalDate.parse("1990-01-01"))
        .birthRegistrationState("Sample State")
        .marriageCertificateNumber("SAMPLE-MARRIAGE-12345")
        .firstPartnerName("Jamie")
        .lastPartnerName("Example")
        .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_marriage_certificate'],
    'consent' => true,
    'first_name' => 'John',
    'last_name' => 'Doe',
    'birth_registration_number' => 'SAMPLE-BIRTH-12345',
    'birth_registration_date' => '1990-01-01',
    'birth_registration_state' => 'Sample State',
    'marriage_certificate_number' => 'SAMPLE-MARRIAGE-12345',
    'first_partner_name' => 'Jamie',
    'last_partner_name' => 'Example',
    '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_marriage_certificate"],
  consent: true,
  first_name: "John",
  last_name: "Doe",
  birth_registration_number: "SAMPLE-BIRTH-12345",
  birth_registration_date: "1990-01-01",
  birth_registration_state: "Sample State",
  marriage_certificate_number: "SAMPLE-MARRIAGE-12345",
  first_partner_name: "Jamie",
  last_partner_name: "Example",
  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_marriage_certificate" },
    Consent = true,
    FirstName = "John",
    LastName = "Doe",
    BirthRegistrationNumber = "SAMPLE-BIRTH-12345",
    BirthRegistrationDate = "1990-01-01",
    BirthRegistrationState = "Sample State",
    MarriageCertificateNumber = "SAMPLE-MARRIAGE-12345",
    FirstPartnerName = "Jamie",
    LastPartnerName = "Example",
    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_marriage_certificate",
      "service_name": "Australia - DVS – Marriage Certificate",
      "source_data": {
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "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_marriage_certificate",
      "service_name": "Australia - DVS – Marriage Certificate",
      "source_data": {
        "first_name": "John",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "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_marriage_certificate",
      "service_name": "Australia - DVS – Marriage Certificate",
      "source_data": {
        "full_name": "NO_MATCH",
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "full_name": "no_match",
        "identification_number": "no_match"
      }
    }
  ]
}
```

## البيانات المُعادة

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

* `first_name`
* `identification_number`
* `last_name`

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

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

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