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"
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)
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);
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)
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
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());
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
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));
{
"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"
}
}
]
}
{
"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"
}
}
]
}
{
"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"
}
}
]
}
🇦🇺 أستراليا
التحقق من شهادة الجنسية في أستراليا (DVS) API
التحقق من شهادة الجنسية الأسترالية عبر قاعدة البيانات الرسمية باستخدام Didit. الدفع لكل استدعاء بدءاً من $0.75، دون عقود أو حد أدنى.
POST
/
v3
/
database-validation
/
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"
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)
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);
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)
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
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());
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
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));
{
"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"
}
}
]
}
{
"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"
}
}
]
}
{
"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"
}
}
]
}
يتحقق من بيانات الإدخال مقابل خدمة التحقق من المستندات (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). إلى أن يُربط هذا الحقل، يعرض محرر سير العمل هذه الخدمة معطّلة ويذكر المدخل الناقص. وعند التشغيل، يعني المدخل الناقص أن الفحص يُتخطى قبل أي استعلام، فلا تُحتسب عليك تكلفة قاعدة بيانات لم يكن بالإمكان الاستعلام منها.
معاملات نص الطلب
string
افتراضي:"AUS"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال:
AUSstring
افتراضي:"aus_citizenship_certificate"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصوراً على قاعدة البيانات هذه تحديداً.مثال:
aus_citizenship_certificateboolean
افتراضي:"true"
مطلوب
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال:
truestring
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال:
Johnstring
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال:
Doestring
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بالصيغة
YYYY-MM-DD.مثال: 1990-01-01string
افتراضي:"SAMPLE-CERT-12345"
مطلوب
القيمة
citizenship_certificate_number المطلوبة من خدمة قاعدة البيانات هذه.مثال: SAMPLE-CERT-12345string
الاسم الأوسط، عند توفره.مثال:
Demostring
افتراضي:"user-1234"
معرّفك الثابت لهذا الشخص، مثل معرّف المستخدم الداخلي لديك. تستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، وتقليل الضجيج الناتج عن اكتشاف التكرار.مثال:
user-1234قواعد الإدخال وملاحظات التحقق
- أرسل الحقول المذكورة أعلاه كما التُقطت من المستخدم أو من المستند تماماً.
- تتحقق Didit من الحقول المطلوبة قبل استدعاء قاعدة البيانات. الطلبات المرفوضة قبل الوصول إلى مصدر البيانات لا تُحتسب.
كيفية الاستدعاء
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"
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)
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);
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)
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
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());
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
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 المعروضة هي الحالة الافتراضية للميزة، ويمكن أن تتجاوزها إجراءات المطابقة الجزئية / عدم المطابقة التي تضبطها.MATCH: أكّد السجل الهوية، وتطابقت كل الحقول المفحوصة.{
"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: وُجد رقم الهوية، لكن حقلاً شخصياً واحداً أو أكثر (عادةً الاسم أو تاريخ الميلاد) لم يتطابق تماماً.{
"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: لم يُرجع السجل أي تطابق مع البيانات المُرسَلة.{
"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_birthfirst_nameidentification_numberlast_namemiddle_name
الأسعار واتفاقيات مستوى الخدمة
تُحتسب استعلامات أستراليا - DVS - شهادة الجنسية فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.- السعر لكل استدعاء: $0.75 دولار أمريكي.
- الفوترة: لكل استعلام ناجح. لا تُحتسب عليك تكلفة عندما يكون السجل غير متاح، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
- زمن الاستجابة: المئين 95 النموذجي أقل من 2 ثانية.
- التوفر: 99.9% لكل ربع سنة من جهة Didit؛ أما توفر مصدر البيانات الخارجي فيختلف حسب الدولة ومجموعة البيانات.
متابعة القراءة
آخر تعديل في ٧ نوفمبر ٢٠٢٦