curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=MYS" \
-F "services=mys_national_id" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "full_name=John Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=111111111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="MYS",
services=["mys_national_id"],
consent=True,
full_name="John Doe",
date_of_birth="1990-01-01",
national_id="111111111111",
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: "MYS",
services: ["mys_national_id"],
consent: true,
full_name: "John Doe",
date_of_birth: "1990-01-01",
national_id: "111111111111",
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: "MYS",
Services: didit.Some([]string{"mys_national_id"}),
Consent: didit.Bool(true),
FullName: didit.String("John Doe"),
DateOfBirth: didit.String("1990-01-01"),
NationalID: didit.String("111111111111"),
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("MYS")
.services(List.of("mys_national_id"))
.consent(true)
.fullName("John Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.nationalId("111111111111")
.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' => 'MYS',
'services' => ['mys_national_id'],
'consent' => true,
'full_name' => 'John Doe',
'date_of_birth' => '1990-01-01',
'national_id' => '111111111111',
'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: "MYS",
services: ["mys_national_id"],
consent: true,
full_name: "John Doe",
date_of_birth: "1990-01-01",
national_id: "111111111111",
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 = "MYS",
Services = new string[] { "mys_national_id" },
Consent = true,
FullName = "John Doe",
DateOfBirth = "1990-01-01",
NationalId = "111111111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "MYS",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia National ID",
"source_data": {
"address": "123 Sample Street",
"address_match_score": "1.000",
"city": "Sample City",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"postal_code": "10001",
"state": "Sample State",
"street": "sample_value"
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "MYS",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia National ID",
"source_data": {
"address": "123 Sample Street",
"address_match_score": "1.000",
"city": "Sample City",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"postal_code": "10001",
"state": "Sample State",
"street": "sample_value"
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "MYS",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia 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"
}
}
]
}
Validasi Database
Verifikasi ID Nasional Malaysia API: Pencocokan Data
Validasi ID nasional Malaysia via database resmi, infrastruktur Didit. Bayar per panggilan mulai $0.59, tanpa kontrak atau minimum.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=MYS" \
-F "services=mys_national_id" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "full_name=John Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=111111111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="MYS",
services=["mys_national_id"],
consent=True,
full_name="John Doe",
date_of_birth="1990-01-01",
national_id="111111111111",
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: "MYS",
services: ["mys_national_id"],
consent: true,
full_name: "John Doe",
date_of_birth: "1990-01-01",
national_id: "111111111111",
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: "MYS",
Services: didit.Some([]string{"mys_national_id"}),
Consent: didit.Bool(true),
FullName: didit.String("John Doe"),
DateOfBirth: didit.String("1990-01-01"),
NationalID: didit.String("111111111111"),
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("MYS")
.services(List.of("mys_national_id"))
.consent(true)
.fullName("John Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.nationalId("111111111111")
.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' => 'MYS',
'services' => ['mys_national_id'],
'consent' => true,
'full_name' => 'John Doe',
'date_of_birth' => '1990-01-01',
'national_id' => '111111111111',
'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: "MYS",
services: ["mys_national_id"],
consent: true,
full_name: "John Doe",
date_of_birth: "1990-01-01",
national_id: "111111111111",
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 = "MYS",
Services = new string[] { "mys_national_id" },
Consent = true,
FullName = "John Doe",
DateOfBirth = "1990-01-01",
NationalId = "111111111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "MYS",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia National ID",
"source_data": {
"address": "123 Sample Street",
"address_match_score": "1.000",
"city": "Sample City",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"postal_code": "10001",
"state": "Sample State",
"street": "sample_value"
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "MYS",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia National ID",
"source_data": {
"address": "123 Sample Street",
"address_match_score": "1.000",
"city": "Sample City",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"postal_code": "10001",
"state": "Sample State",
"street": "sample_value"
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "MYS",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia 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"
}
}
]
}
Memverifikasi data input terhadap database lembaga pemerintah yang berisi data warga negara Malaysia. Didit menyediakan layanan ini melalui
POST /v3/database-validation/ agar Anda dapat memverifikasi data yang dikirim terhadap sumber otoritatif dan menerima hasil kecocokan yang sudah dinormalisasi.
Cakupan
- Cakupan: > 75%
- Negara: Malaysia
- ID layanan:
mys_national_id - Domain data: Identitas
- Kategori: NationalIDRegistry
Input
| Kolom | Wajib | Contoh |
|---|---|---|
full_name | Ya | John Doe |
date_of_birth | Ya | 1990-01-01 |
national_id | Ya | 111111111111 |
address.street_1 | Tidak | 123 Sample Street |
address.street_2 | Tidak | Unit 4 |
address.city | Tidak | Sample City |
address.region | Tidak | Sample State |
address.postal_code | Tidak | 10001 |
phone | Tidak | +15550101000 |
vendor_data | Tidak | user-1234 |
- Input wajib:
full_name,date_of_birth,national_id - Input opsional:
address.street_1,address.street_2,address.city,address.region,address.postal_code,phone,vendor_data - Persetujuan: Wajib
- Ketersediaan alur kerja: Tersedia dalam alur kerja
- Cakupan: > 75%
- Harga: $0.59 per kueri yang berhasil
Parameter body
string
default:"MYS"
wajib
Kode negara ISO 3166-1 alpha-3 untuk layanan database ini.Contoh:
MYSstring
default:"mys_national_id"
wajib
Array yang berisi ID layanan ini. Mengunci layanan membuat permintaan hanya mengacu pada database yang tepat ini.Contoh:
mys_national_idboolean
default:"true"
wajib
Persetujuan eksplisit dari pengguna akhir untuk layanan ini.Contoh:
truestring
default:"John Doe"
wajib
Nama resmi lengkap untuk divalidasi.Contoh:
John Doestring
default:"1990-01-01"
wajib
Tanggal lahir dalam format
YYYY-MM-DD.Contoh: 1990-01-01string
default:"111111111111"
wajib
Nomor identitas nasional untuk layanan ini.Contoh:
111111111111object
Objek alamat tempat tinggal terstruktur. Gunakan
street_1, street_2, city, region, postal_code, dan country. String alamat lama yang lengkap masih diterima, tetapi tidak disarankan.Contoh: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}string
Nomor telepon dalam format internasional.Contoh:
+15550101000string
default:"user-1234"
Referensi pengguna tetap Anda untuk orang ini, misalnya ID pengguna internal Anda. Didit menggunakannya untuk menautkan pemeriksaan terpisah ke pengguna akhir yang sama dan mengurangi gangguan dalam deteksi duplikat.Contoh:
user-1234Aturan input & catatan validasi
addressbersifat opsional untuk layanan ini. Anda dapat mengirim satu stringaddressyang lengkap dan Didit akan memecahnya menjadi elemen alamat terstruktur jika memungkinkan, atau Anda dapat mengirim kolom alamat terstruktur secara eksplisit.national_idhanya boleh berisi digit; hapus spasi, tanda hubung, dan tanda baca sebelum mengirim permintaan.national_idharus tepat 12 karakter.- Untuk layanan berbasis alamat, kirim kolom alamat terstruktur alih-alih satu string
addressbila memungkinkan. address.street_1adalah alamat jalan, termasuk nomor dan jenis jalan.address.street_2adalah apartemen, unit, gedung, lantai, atau baris alamat tambahan. Kirim hanya jika Anda memilikinya.address.cityadalah kota, kecamatan, distrik, kelurahan, atau lingkungan.address.regionadalah negara bagian, provinsi, wilayah, atau kota.address.postal_codeadalah kode pos.- Layanan database berbasis alamat memerlukan minimal alamat jalan dan kode pos. Permintaan yang ditolak sebelum pencarian sumber tidak dikenai biaya.
Cara memanggilnya
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=MYS" \
-F "services=mys_national_id" \
-F "vendor_data=user-1234" \
-F "consent=true" \
-F "full_name=John Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=111111111111"
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.database_validation.validate(
issuing_state="MYS",
services=["mys_national_id"],
consent=True,
full_name="John Doe",
date_of_birth="1990-01-01",
national_id="111111111111",
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: "MYS",
services: ["mys_national_id"],
consent: true,
full_name: "John Doe",
date_of_birth: "1990-01-01",
national_id: "111111111111",
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: "MYS",
Services: didit.Some([]string{"mys_national_id"}),
Consent: didit.Bool(true),
FullName: didit.String("John Doe"),
DateOfBirth: didit.String("1990-01-01"),
NationalID: didit.String("111111111111"),
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("MYS")
.services(List.of("mys_national_id"))
.consent(true)
.fullName("John Doe")
.dateOfBirth(LocalDate.parse("1990-01-01"))
.nationalId("111111111111")
.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' => 'MYS',
'services' => ['mys_national_id'],
'consent' => true,
'full_name' => 'John Doe',
'date_of_birth' => '1990-01-01',
'national_id' => '111111111111',
'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: "MYS",
services: ["mys_national_id"],
consent: true,
full_name: "John Doe",
date_of_birth: "1990-01-01",
national_id: "111111111111",
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 = "MYS",
Services = new string[] { "mys_national_id" },
Consent = true,
FullName = "John Doe",
DateOfBirth = "1990-01-01",
NationalId = "111111111111",
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));
Setiap panggilan yang berhasil mengembalikan HTTP 200. Kolom outcome_code menunjukkan apa yang sebenarnya terjadi, misalnya membedakan ketidakcocokan biometrik yang sebenarnya (BIOMETRIC_NO_MATCH) dari swafoto yang tidak dapat dibaca (BIOMETRIC_IMAGE_UNUSABLE). status yang ditampilkan adalah status fitur default; tindakan Partial Match / No Match yang Anda konfigurasi dapat menggantinya.MATCH — Registri mengonfirmasi identitas dan setiap kolom yang diperiksa cocok.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "MYS",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia National ID",
"source_data": {
"address": "123 Sample Street",
"address_match_score": "1.000",
"city": "Sample City",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"postal_code": "10001",
"state": "Sample State",
"street": "sample_value"
},
"validation": {
"date_of_birth": "full_match",
"full_name": "full_match",
"identification_number": "full_match"
}
}
]
}
PARTIAL_MATCH — Nomor identifikasi ditemukan, tetapi satu atau lebih kolom pribadi (biasanya nama atau tanggal lahir) tidak sepenuhnya cocok.{
"request_id": "req_01H…",
"status": "In Review",
"issuing_state": "MYS",
"match_type": "partial_match",
"validations": [
{
"outcome_code": "PARTIAL_MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia National ID",
"source_data": {
"address": "123 Sample Street",
"address_match_score": "1.000",
"city": "Sample City",
"date_of_birth": "1990-01-01",
"identification_number": "SAMPLE-ID-12345",
"postal_code": "10001",
"state": "Sample State",
"street": "sample_value"
},
"validation": {
"date_of_birth": "full_match",
"full_name": "no_match",
"identification_number": "full_match"
}
}
]
}
NO_MATCH — Registri tidak mengembalikan kecocokan untuk data yang dikirim.{
"request_id": "req_01H…",
"status": "Declined",
"issuing_state": "MYS",
"match_type": "no_match",
"validations": [
{
"outcome_code": "NO_MATCH",
"service_id": "mys_national_id",
"service_name": "Malaysia 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"
}
}
]
}
Data yang dikembalikan
Kolom yang tepat yang ditampilkan disource_data bergantung pada apa yang dikembalikan registri. Contoh yang dihasilkan untuk mys_national_id saat ini mendokumentasikan bentuk ternormalisasi berikut:
addressaddress_match_scorecitydate_of_birthidentification_numberpostal_codestatestreet
Harga & SLA
Kueri ID Nasional Malaysia hanya ditagih ketika Didit menerima hasil yang konklusif dari sumber validasi.- Harga per panggilan: $0.59 USD.
- Penagihan: per kueri yang berhasil. Anda tidak dikenai biaya ketika registri tidak dapat dijangkau, ketika kolom wajib tidak ada, atau ketika permintaan ditolak sebelum mencapai sumber.
- Latensi: p95 tipikal < 2 s.
- Ketersediaan: 99.9% per kuartal di sisi Didit; ketersediaan sumber hilir bervariasi menurut negara dan set data.
Lanjutkan membaca
Terakhir diubah pada 7 November 2026