Didit 身份证件验证 API

概述

通过提交身份证件正面和背面图像来验证身份证明文件。执行OCR提取、MRZ解析、真实性检查和证件活体检测。

关键限制：

• - 支持的格式：JPEG、PNG、WebP、TIFF
• 最大文件大小：每张图像 5MB
• 所有证件边角必须可见，全彩色，无眩光/阴影
• 仅限原始实时照片（不接受截图、扫描件或数字副本）

覆盖范围： 4,000+ 种证件类型，220+ 个国家/地区，130+ 种语言。支持护照、国民身份证、驾驶执照和居留许可。

处理流程：

1. 1. 智能采集与证件类型检测
2. OCR文本提取 + MRZ/条码解析
3. 模板匹配、安全特征验证、篡改检测
4. 证件活体检测（检测屏幕截图、打印副本、人像篡改）

API 参考文档： https://docs.didit.me/standalone-apis/id-verification
功能指南： https://docs.didit.me/core-technology/id-verification/overview
支持的证件： https://docs.didit.me/core-technology/id-verification/supported-documents-id-verification

身份验证

所有请求都需要 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/id-verification/

请求标头

请求参数（multipart/form-data）

示例

python
import requests

response = requests.post(
https://verification.didit.me/v3/id-verification/,
headers={x-api-key: YOURAPIKEY},
files={
front_image: (front.jpg, open(front.jpg, rb), image/jpeg),
back_image: (back.jpg, open(back.jpg, rb), image/jpeg),
},
data={vendor_data: user-123},
)

typescript
const formData = new FormData();
formData.append(front_image, frontImageFile);
formData.append(back_image, backImageFile);
formData.append(vendor_data, user-123);

const response = await fetch(https://verification.didit.me/v3/id-verification/, {
method: POST,
headers: { x-api-key: YOURAPIKEY },
body: formData,
});

响应（200 OK）

json
{
request_id: a1b2c3d4-...,
id_verification: {
status: Approved,
document_type: Identity Card,
document_number: YZA123456,
personal_number: X9876543L,
first_name: Elena,
last_name: Martínez Sánchez,
full_name: Elena Martínez Sánchez,
dateofbirth: 1985-03-15,
age: 40,
gender: F,
nationality: ESP,
issuing_state: ESP,
issuingstatename: Spain,
expiration_date: 2030-08-21,
dateofissue: 2020-08-21,
address: Calle Mayor 10, Madrid,
formatted_address: Calle Mayor 10, 28013 Madrid, Spain,
placeofbirth: Valencia,
portrait_image: ,
frontdocumentimage: ,
backdocumentimage: ,
mrz: {
surname: MARTINEZ SANCHEZ,
given_name: ELENA,
document_type: I,
document_number: YZA123456,
country: ESP,
nationality: ESP,
birth_date: 850315,
expiry_date: 300821,
sex: F
},
parsedaddress: {city: Madrid, region: ..., postalcode: 28013, country: ES},
warnings: []
},
created_at: 2025-05-01T13:11:07.977806Z
}

状态值

错误响应

响应字段参考

警告标签

自动拒绝（始终）