马来西亚国民身份验证API (ZH)
实时验证马来西亚国民身份证件，对照该国官方政府身份注册机构的数据，仅对得出结论的结果收费。本指南涵盖了端点、参数、响应模式、定价和集成。.
在马来西亚，用户注册意味着确认他们是其所声称的身份。这需要对照由马来西亚公民数据组成的政府机构数据库验证输入数据。一份文件或一个输入的细节只能证明数据存在——而不是证明它是真实的或属于您面前的人。马来西亚国民身份验证通过对照该国官方政府身份注册机构检查数据来弥补这一差距。本指南解释了此检查的功能、具体技术细节以及如何在几分钟内完成集成。
主要收获：
- 检查内容 — 马来西亚国民身份验证对照该国官方政府身份注册机构验证国民身份证。
- 返回内容 — 规范化的
match_type以及字段级别的结果，您可以直接将其路由到批准/审查/拒绝逻辑中。 - 重要性 — 文件可以伪造；注册记录不能。对照权威政府来源验证身份证件可确认持有人真实且身份正确。
- 如何使用 — 向 Didit 的数据库验证端点发送一个
POST请求，或使用无代码工作流模块。每次得出结论的查询费用为0.16美元，几秒钟内即可获得结果。
马来西亚国民身份验证的内容
对照由马来西亚公民数据组成的政府机构数据库验证输入数据。Didit 通过一个单一端点公开此服务，因此您可以对照该国官方政府身份注册机构验证提交的数据，并接收结构化、规范化的结果——而不是您必须自行解析的原始注册表转储。
一个结论性响应会返回匹配的source_data和一个字段级别的validation块，以便您的风险引擎获得清晰、机器可读的结论。
重要性
文件可以伪造；注册记录不能。对照权威政府来源验证身份证件可确认持有人真实且身份正确。
对于马来西亚受监管的企业——金融科技、加密平台、贷款机构、市场和游戏运营商——对照权威来源进行检查可生成可辩护、可审计的记录，证明身份已在源头确认，而不仅仅是从表格或照片中捕获。
技术细节
Didit 通过统一的数据库验证端点公开此服务。这是一个单一的POST请求——无需SDK。
端点
POST /v3/database-validation/请求参数
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
issuing_state | string | 是 | ISO 3166-1 alpha-3 国家代码。使用MYS。 |
services | string | 是 | 服务标识符。使用mys_national_id。 |
full_name | string | 是 | 全名。 |
date_of_birth | string | 是 | 出生日期。 |
national_id | string | 是 | 国民身份证号码。 |
address | string | 否 | 地址（可选交叉核对）。 |
phone | string | 否 | 电话（可选交叉核对）。 |
示例请求
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 "full_name=John Doe" \
-F "date_of_birth=1990-01-01" \
-F "national_id=1111111"示例响应（结论性匹配）
{
"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": {
"address": "full_match",
"date_of_birth": "full_match",
"identification_number": "full_match"
}
}
]
}性能和计费
- 延迟： 通常几秒钟。
- 成本： 每次得出结论的查询费用为0.16美元。仅对得出结论的结果收费——源头停机、字段缺失或预源拒绝不收费。
- 可靠性： 运行在 Didit 的基础设施上，季度正常运行时间目标为99.9%。
- 同意： 此服务需要记录最终用户同意。在调用端点之前捕获并存储它。
使用场景
- 金融科技和新型银行 — 在马来西亚开设钱包或提供信贷之前，确认真实、可验证的账户持有人。
- 加密货币和Web3 — 通过权威来源的身份证明满足 VASP 入职要求。
- 贷款 — 通过源头验证的数据减少合成身份和第一方欺诈。
- 市场和零工平台 — 对照权威数据（而不仅仅是自我报告的表格）验证用户。
- iGaming — 通过可审计的记录满足马来西亚玩家的身份和资格检查。
如何与 Didit 集成
您可以通过两种方式运行马来西亚国民身份验证：
- 无代码工作流。 在 Didit 商业控制台中，打开工作流构建器，添加数据库验证模块，选择马来西亚 → 马来西亚国民身份验证，并激活它。匹配的用户会自动路由——无需工程技术。
- 直接API。 使用
services=mys_national_id调用上面显示的/v3/database-validation/端点。读取match_type和字段级别的validation块以驱动您的批准/审查/拒绝逻辑。
每个 Didit 账户每月包含500次免费验证，因此您可以在支付任何查询费用之前测试完整的流程。
常见问题
马来西亚国民身份验证检查确认什么？
它对照该国官方政府身份注册机构验证提交的数据，并返回规范化的匹配结果，以便您了解国民身份证是否存在于权威来源以及哪些字段匹配。
如果源头暂时不可用怎么办？
您不会被收费。计费仅适用于得出结论的结果——源头停机、字段缺失和预源拒绝是免费的。
检查速度有多快？
数据库验证通常在几秒钟内返回，因此它适合实时入职流程。
我需要SDK吗？
不需要。检查是一个单一的 HTTPS POST请求到一个端点。您也可以将其连接到商业控制台中的无代码工作流。
准备好开始了吗？
立即验证您的第一个马来西亚国民身份证。
- 阅读API参考： 马来西亚国民身份验证
- 查看所有数据库验证： 数据库验证定价和覆盖范围
- 开始构建： 创建免费的 Didit 账户 — 每月500次免费验证。