curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=THA" \
-F "services=tha_national_id" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=1111111111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="THA",
services=["tha_national_id"],
consent=True,
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
national_id="1111111111111",
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: "THA",
services: ["tha_national_id"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
national_id: "1111111111111",
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: "THA",
Services: didit.Some([]string{"tha_national_id"}),
Consent: didit.Bool(true),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
NationalID: didit.String("1111111111111"),
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("THA")
.services(List.of("tha_national_id"))
.consent(true)
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.nationalId("1111111111111")
.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' => 'THA',
'services' => ['tha_national_id'],
'consent' => true,
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'national_id' => '1111111111111',
'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: "THA",
services: ["tha_national_id"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
national_id: "1111111111111",
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 = "THA",
Services = new string[] { "tha_national_id" },
Consent = true,
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
NationalId = "1111111111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "THA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"source_data": {
"address_match_score": "1.000",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": true,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "THA",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"source_data": {
"address_match_score": "1.000",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": false,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "THA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"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"
}
}
]
}
التحقق من قواعد البيانات
التحقق من الهوية الوطنية في تايلاند: مطابقة البيانات
التحقق من الهوية الوطنية في تايلاند عبر قواعد البيانات الرسمية من 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=THA" \
-F "services=tha_national_id" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=1111111111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="THA",
services=["tha_national_id"],
consent=True,
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
national_id="1111111111111",
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: "THA",
services: ["tha_national_id"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
national_id: "1111111111111",
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: "THA",
Services: didit.Some([]string{"tha_national_id"}),
Consent: didit.Bool(true),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
NationalID: didit.String("1111111111111"),
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("THA")
.services(List.of("tha_national_id"))
.consent(true)
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.nationalId("1111111111111")
.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' => 'THA',
'services' => ['tha_national_id'],
'consent' => true,
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'national_id' => '1111111111111',
'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: "THA",
services: ["tha_national_id"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
national_id: "1111111111111",
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 = "THA",
Services = new string[] { "tha_national_id" },
Consent = true,
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
NationalId = "1111111111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "THA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"source_data": {
"address_match_score": "1.000",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": true,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "THA",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"source_data": {
"address_match_score": "1.000",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": false,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "THA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"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"
}
}
]
}
يتحقق من بيانات الإدخال مقابل بيانات رقم الهوية الوطنية المستمدة من جهة حكومية. تتيح Didit هذه الخدمة عبر
POST /v3/database-validation/ حتى تتمكن من التحقق من البيانات المُرسلة مقابل المصدر الموثوق، واستلام نتائج مطابقة موحّدة. تنسيق الإدخال: يقبل national_id رقم الهوية الوطنية التايلاندية، وهو 13 رقمًا يكون آخرها رقم التحقق mod-11 (بأوزان من 13 إلى 2 على الأرقام الاثني عشر الأولى).
التغطية
- التغطية: ~ 90%
- الدولة: تايلاند
- معرّف الخدمة:
tha_national_id - نطاق البيانات: الهوية
- الفئة: NationalIDRegistry
المدخلات
| الحقل | مطلوب | مثال |
|---|---|---|
first_name | نعم | John |
last_name | نعم | Doe |
date_of_birth | نعم | 1990-01-01 |
national_id | نعم | 1111111111111 |
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وnational_id - الحقول الاختيارية:
address.street_1وaddress.street_2وaddress.cityوaddress.regionوaddress.postal_codeوvendor_data - الموافقة: مطلوبة
- توفر سير العمل: متاح في سير العمل
- التغطية: ~ 90%
- السعر: $0.59 لكل استعلام ناجح
معاملات الجسم
string
افتراضي:"THA"
مطلوب
رمز الدولة ISO 3166-1 alpha-3 لخدمة قاعدة البيانات هذه.مثال:
THAstring
افتراضي:"tha_national_id"
مطلوب
مصفوفة تحتوي على معرّف هذه الخدمة. تثبيت الخدمة يُبقي الطلب مقصورًا على قاعدة البيانات المحددة هذه.مثال:
tha_national_idboolean
افتراضي:"true"
مطلوب
موافقة صريحة من المستخدم النهائي على هذه الخدمة.مثال:
truestring
افتراضي:"John"
مطلوب
الاسم الأول المراد التحقق منه.مثال:
Johnstring
افتراضي:"Doe"
مطلوب
اسم العائلة المراد التحقق منه.مثال:
Doestring
افتراضي:"1990-01-01"
مطلوب
تاريخ الميلاد بتنسيق
YYYY-MM-DD.مثال: 1990-01-01string
افتراضي:"1111111111111"
مطلوب
رقم الهوية الوطنية لهذه الخدمة.مثال:
1111111111111object
كائن عنوان سكني منظّم. استخدم
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 بتقسيمها إلى عناصر عنوان منظّمة عند الإمكان، أو يمكنك إرسال الحقول المنظّمة بشكل صريح.- رقم الهوية الوطنية التايلاندية: 13 رقمًا يكون آخرها رقم التحقق mod-11 (بأوزان من 13 إلى 2 على الأرقام الاثني عشر الأولى).
- يجب أن يحتوي
national_idعلى أرقام فقط؛ أزل المسافات والشرطات وعلامات الترقيم قبل إرسال الطلب. - يجب أن يكون طول
national_id13 حرفًا بالضبط. - يُتحقق من رقم التحقق الأخير في الرقم الوطني التايلاندي (mod 11)؛ يُرفض الرقم الذي يفشل في هذا الفحص قبل البحث، ولا تُحتسب عليه رسوم.
- بالنسبة لخدمات العناوين، أرسل حقول العنوان المنظّمة بدلًا من سلسلة
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=THA" \
-F "services=tha_national_id" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "first_name=John" \
-F "last_name=Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=1111111111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="THA",
services=["tha_national_id"],
consent=True,
first_name="John",
last_name="Doe",
date_of_birth="1990-01-01",
national_id="1111111111111",
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: "THA",
services: ["tha_national_id"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
national_id: "1111111111111",
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: "THA",
Services: didit.Some([]string{"tha_national_id"}),
Consent: didit.Bool(true),
FirstName: didit.String("John"),
LastName: didit.String("Doe"),
DateOfBirth: didit.String("1990-01-01"),
NationalID: didit.String("1111111111111"),
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("THA")
.services(List.of("tha_national_id"))
.consent(true)
.firstName("John")
.lastName("Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.nationalId("1111111111111")
.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' => 'THA',
'services' => ['tha_national_id'],
'consent' => true,
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-01',
'national_id' => '1111111111111',
'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: "THA",
services: ["tha_national_id"],
consent: true,
first_name: "John",
last_name: "Doe",
date_of_birth: "1990-01-01",
national_id: "1111111111111",
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 = "THA",
Services = new string[] { "tha_national_id" },
Consent = true,
FirstName = "John",
LastName = "Doe",
DateOfBirth = "1990-01-01",
NationalId = "1111111111111",
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": "THA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"source_data": {
"address_match_score": "1.000",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": true,
"identification_number": true
}
},
"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": "THA",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"source_data": {
"address_match_score": "1.000",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"name_match_score": "1.000",
"verifications": {
"date_of_birth": true,
"full_name": false,
"identification_number": true
}
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
NO_MATCH — لم يُرجع السجل أي تطابق للبيانات المُرسلة.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "THA",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "tha_national_id",
"service_name": "Thailand National ID",
"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 على ما يُرجعه السجل. يوثّق المثال المولّد لـ tha_national_id حالياً هذا الشكل الموحّد:
address_match_scoredate_of_birthidentification_numbername_match_score
الأسعار واتفاقيات مستوى الخدمة
تُحتسب استعلامات رقم الهوية الوطنية التايلاندية فقط عندما تستلم Didit نتيجة حاسمة من مصدر التحقق.- سعر كل استدعاء: $0.59 دولار أمريكي.
- الفوترة: لكل استعلام ناجح. لا يُحتسب عليك أي رسوم عندما يكون السجل غير قابل للوصول، أو عندما تكون الحقول المطلوبة ناقصة، أو عندما يُرفض الطلب قبل وصوله إلى المصدر.
- زمن الاستجابة: المعتاد p95 < 2 s.
- التوفر: 99.9% لكل ربع سنة من جهة Didit؛ ويختلف توفر المصدر النهائي بحسب الدولة ومجموعة البيانات.
متابعة القراءة
آخر تعديل في ٧ نوفمبر ٢٠٢٦