curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=PHL" \
-F "services=phl_residential" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="PHL",
services=["phl_residential"],
consent=True,
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
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: "PHL",
services: ["phl_residential"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
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: "PHL",
Services: didit.Some([]string{"phl_residential"}),
Consent: didit.Bool(true),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
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("PHL")
.services(List.of("phl_residential"))
.consent(true)
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.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' => 'PHL',
'services' => ['phl_residential'],
'consent' => true,
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'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: "PHL",
services: ["phl_residential"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
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 = "PHL",
Services = new string[] { "phl_residential" },
Consent = true,
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "PHL",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "1990-01-01",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "PHL",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "1990-01-01",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": false
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "PHL",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "NO_MATCH",
"full_name": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"full_name": "no_match"
}
}
]
}
التحقق من قواعد البيانات
التحقق من العنوان السكني في الفلبين: مطابقة الهوية
التحقق من قاعدة بيانات الفلبين الموثوقة عبر البنية التحتية لتحقق الهوية من Didit. الدفع لكل استدعاء من $0.59، بلا عقود ولا حد أدنى.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=PHL" \
-F "services=phl_residential" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="PHL",
services=["phl_residential"],
consent=True,
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
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: "PHL",
services: ["phl_residential"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
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: "PHL",
Services: didit.Some([]string{"phl_residential"}),
Consent: didit.Bool(true),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
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("PHL")
.services(List.of("phl_residential"))
.consent(true)
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.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' => 'PHL',
'services' => ['phl_residential'],
'consent' => true,
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'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: "PHL",
services: ["phl_residential"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
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 = "PHL",
Services = new string[] { "phl_residential" },
Consent = true,
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "PHL",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "1990-01-01",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "PHL",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "1990-01-01",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": false
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "PHL",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "NO_MATCH",
"full_name": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"full_name": "no_match"
}
}
]
}
يتحقق من بيانات المدخلات مقابل قاعدة بيانات حكومية تضم بيانات المواطنين الفلبينيين. يوفّر Didit هذه الخدمة عبر
POST /v3/database-validation/ حتى تتمكن من التحقق من البيانات المُقدَّمة مقابل المصدر الرسمي، والحصول على نتائج تطابق موحّدة.
التغطية
- التغطية: > 80%
- الدولة: الفلبين
- معرّف الخدمة:
phl_residential - نطاق البيانات: العنوان
- الفئة: سكنية
المدخلات
| الحقل | مطلوب | مثال |
|---|---|---|
first_name | نعم | John |
last_name | نعم | Doe |
date_of_birth | نعم | 1990-01-01 |
address.street_1 | لا | 123 Sample Street |
address.street_2 | لا | Unit 4 |
address.city | لا | Sample City |
address.region | لا | Sample State |
address.postal_code | لا | 10001 |
vendor_data | لا | user-1234 |
- المدخلات المطلوبة:
first_name،last_name،date_of_birth - المدخلات الاختيارية:
address.street_1،address.street_2،address.city،address.region،address.postal_code،vendor_data - الموافقة: مطلوبة
- توفّر سير العمل: متاح في سير العمل
- التغطية: > 80%
- السعر: $0.59 لكل استعلام ناجح
معاملات نص الطلب
string
افتراضي:"PHL"
مطلوب
رمز الدولة وفق ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال:
PHLstring
افتراضي:"phl_residential"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقتصراً على قاعدة البيانات المحددة هذه تحديداً.مثال:
phl_residentialboolean
افتراضي:"true"
مطلوب
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال:
truestring
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال:
Johnstring
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال:
Doestring
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بصيغة
YYYY-MM-DD.مثال: 1990-01-01object
كائن عنوان سكني مُنظّم. استخدم
street_1 وstreet_2 وcity وregion وpostal_code وcountry. ما زال يُقبل نص العنوان الكامل القديم، لكنه غير موصى به.مثال: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}string
افتراضي:"user-1234"
المرجع الثابت للمستخدم لدى جهتك، مثل معرّف المستخدم الداخلي. يستخدمه Didit لربط الفحوصات المستقلة بالمستخدم النهائي نفسه، ولتقليل ضوضاء اكتشاف التكرار.مثال:
user-1234قواعد المدخلات وملاحظات التحقق
- العنوان
addressاختياري لهذه الخدمة. يمكنك إرسال نص عنوان كامل واحد فيaddress، وسيقسمه Didit إلى عناصر عنوان مُنظّمة كلما أمكن ذلك، أو يمكنك إرسال الحقول المُنظّمة صراحةً. - بالنسبة إلى خدمات قواعد البيانات المعتمدة على العنوان، أرسل حقول العنوان المُنظّمة بدلاً من نص
addressالواحد كلما أمكن. address.street_1هو عنوان الشارع، ويتضمن رقم المبنى ونوع الشارع.address.street_2هو الشقة أو الوحدة أو المبنى أو الطابق أو أي سطر عنوان إضافي. أرسله فقط عندما يتوفر لديك.address.cityهو المدينة أو الضاحية أو المقاطعة أو المنطقة المحلية أو الحي.address.regionهو الولاية أو المحافظة أو الإقليم أو البلدة.address.postal_codeهو الرمز البريدي.- تتطلب خدمات قواعد البيانات المعتمدة على العنوان على الأقل عنوان الشارع والرمز البريدي؛ والطلبات المرفوضة قبل البحث في المصدر لا تُحتسب.
طريقة الاستدعاء
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=PHL" \
-F "services=phl_residential" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="PHL",
services=["phl_residential"],
consent=True,
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
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: "PHL",
services: ["phl_residential"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
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: "PHL",
Services: didit.Some([]string{"phl_residential"}),
Consent: didit.Bool(true),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
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("PHL")
.services(List.of("phl_residential"))
.consent(true)
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.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' => 'PHL',
'services' => ['phl_residential'],
'consent' => true,
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'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: "PHL",
services: ["phl_residential"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
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 = "PHL",
Services = new string[] { "phl_residential" },
Consent = true,
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
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": "PHL",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "1990-01-01",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match"
}
}
]
}
PARTIAL_MATCH: لم يتطابق حقل واحد أو أكثر من الحقول التي تقارنها هذه الخدمة تطابقاً كاملاً. في هذا المثال، لم يتطابق full_name، بينما تطابق date_of_birth.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "PHL",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "1990-01-01",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": false
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match"
}
}
]
}
NO_MATCH: لم يُرجع السجل أي تطابق للبيانات المُقدَّمة.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "PHL",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "phl_residential",
"service_name": "Philippines Residential",
"source_data": {
"date_of_birth": "NO_MATCH",
"full_name": "NO_MATCH"
},
"validation": {
"date_of_birth": "no_match",
"full_name": "no_match"
}
}
]
}
البيانات المُرجعة
تعتمد الحقول الدقيقة المعروضة فيsource_data على ما يُرجعه السجل. يوثّق المثال المُنشأ تلقائياً لـ phl_residential حالياً بنية الحقول الموحّدة التالية:
date_of_birthname_match_score
الأسعار واتفاقيات مستوى الخدمة
تُحتسب رسوم استعلامات الإقامة في الفلبين فقط عندما تتلقى Didit نتيجة حاسمة من مصدر التحقق.- سعر كل استدعاء: $0.59 دولار أمريكي.
- الفوترة: لكل استعلام ناجح. لا تُحتسب أي رسوم عندما يتعذر الوصول إلى السجل، أو عندما تكون الحقول المطلوبة مفقودة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
- زمن الاستجابة: يبلغ p95 النموذجي أقل من ثانيتين.
- التوفر: 99.9% لكل ربع سنة من جانب Didit؛ ويختلف توفر المصادر الخارجية التي تعتمد عليها حسب البلد ومجموعة البيانات.
متابعة القراءة
آخر تعديل في ٧ نوفمبر ٢٠٢٦