Didit 数据库验证 API

概述

根据可信的政府和金融数据库验证个人数据和身份证件。防止合成身份欺诈，确保身份真实性。

关键限制：

• - 至少需要目标国家的国民身份证/证件号码
• 覆盖范围：18个国家（主要为拉丁美洲 + 西班牙）
• 结果：fullmatch（完全匹配）、partialmatch（部分匹配）或 no_match（不匹配）
• 仅按成功查询收费 — 数据不足时不收费

匹配方法：

API 参考： https://docs.didit.me/standalone-apis/database-validation
功能指南： https://docs.didit.me/core-technology/database-validation/overview
支持的国家： https://docs.didit.me/core-technology/database-validation/database-validation-supported-countries

身份验证

所有请求都需要 x-api-key 标头。从 Didit 业务控制台 → API 和 Webhooks 获取您的密钥，或通过编程方式注册（见下文）。

快速入门（还没有账户？）

如果您没有 Didit API 密钥，可通过 2 次 API 调用创建一个：

1. 1. 注册： POST https://apx.didit.me/auth/v2/programmatic/register/，附带 {email: you@gmail.com, password: MyStr0ng!Pass}
2. 检查电子邮件 获取 6 字符 OTP 验证码
3. 验证： POST https://apx.didit.me/auth/v2/programmatic/verify-email/，附带 {email: you@gmail.com, code: A3K9F2} → 响应中包含 api_key

添加积分： GET /v3/billing/balance/ 检查余额，POST /v3/billing/top-up/ 附带 {amountindollars: 50} 获取 Stripe 结账链接。

有关完整平台管理（工作流、会话、用户、计费），请参阅 didit-verification-management 技能。

端点

POST https://verification.didit.me/v3/database-validation/

标头

请求体（JSON）

id_number 字段自动映射到正确的国家特定字段：

示例

python
import requests

response = requests.post(
https://verification.didit.me/v3/database-validation/,
headers={x-api-key: YOURAPIKEY, Content-Type: application/json},
json={
id_number: 12345678,
first_name: Carlos,
last_name: Garcia,
issuing_state: PER,
},
)
print(response.json())

typescript
const response = await fetch(https://verification.didit.me/v3/database-validation/, {
method: POST,
headers: { x-api-key: YOURAPIKEY, Content-Type: application/json },
body: JSON.stringify({
id_number: 12345678,
first_name: Carlos,
last_name: Garcia,
issuing_state: PER,
}),
});

响应（200 OK）

json
{
request_id: a1b2c3d4-...,
database_validation: {
status: Approved,
matchtype: fullmatch,
issuing_state: PER,
validation_type: 1x1,
screened_data: {
personal_number: 12345678,
first_name: Carlos,
last_name: Garcia
},
validations: {
fullname: fullmatch,
identificationnumber: fullmatch
}
}
}

状态值及处理

错误响应

匹配逻辑

姓名匹配

单个姓名组件使用70% Levenshtein 阈值。示例：Christophel vs Christopher = 完全匹配；Chris vs Christopher = 不匹配。

1x1 决策

2x2 决策

需要与2个独立数据源进行匹配：

出生日期和身份证号码匹配为精确匹配 — 无模糊匹配。

警告标签

当触发 COULDNOTPERFORMDATABASEVALIDATION 时，会话进入审核中状态。一旦提供缺失数据，验证将自动重新触发。

支持的国家

| 国家 | 方法 | 覆盖率