Didit 地址证明 API

概述

通过提交图片或PDF文件验证地址证明文件。提取地址信息，执行真实性检查、姓名匹配、地理编码，并返回结构化数据。

关键限制：

• - 支持的格式：JPG、JPEG、PNG、TIFF、PDF
• 最大文件大小：15MB
• 文件签发日期必须在 90天内
• 全彩色，所有边角可见，无数字编辑
• 必须与用于身份验证的身份证件不同

功能： OCR提取、智能文档分类、与身份证件姓名匹配、签发日期验证、含经纬度坐标的地理编码、语言检测、多页支持。

接受的文档类型：

API 参考： https://docs.didit.me/standalone-apis/proof-of-address
功能指南： https://docs.didit.me/core-technology/proof-of-address/overview

身份验证

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

请求头

请求参数（multipart/form-data）

示例

python
import requests

response = requests.post(
https://verification.didit.me/v3/poa/,
headers={x-api-key: YOURAPIKEY},
files={document: (utility_bill.pdf, open(bill.pdf, rb), application/pdf)},
data={vendor_data: user-123},
)
print(response.json())

typescript
const formData = new FormData();
formData.append(document, documentFile);

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

响应（200 OK）

json
{
request_id: a1b2c3d4-...,
poa: {
status: Approved,
issuing_state: ESP,
documenttype: UTILITYBILL,
issuer: Endesa,
issue_date: 2025-01-15,
document_language: es,
nameondocument: Elena Martínez Sánchez,
poa_address: Calle Mayor 10, 28013 Madrid,
poaformattedaddress: Calle Mayor 10, 28013 Madrid, Spain,
poaparsedaddress: {
street_1: Calle Mayor 10,
city: Madrid,
region: Comunidad de Madrid,
postal_code: 28013,
raw_results: {
geometry: {location: {lat: 40.4168, lng: -3.7038}}
}
},
document_file: https://example.com/document.pdf,
warnings: []
},
created_at: 2025-05-01T13:11:07.977806Z
}

状态值及处理

错误响应

响应字段参考

警告标签

自动拒绝

可配置（拒绝/审核/批准）