跳转到主要内容
POST
依据官方 RENAPER 民事登记库核验阿根廷 DNI,并将自拍照与登记库中存档的照片进行人脸比对。覆盖 100% 的人口。Didit 通过 POST /v3/database-validation/ 提供此服务,帮助您将提交的数据与权威来源进行核验,并获得标准化的匹配结果。输入格式:document_number 接受阿根廷 DNI(7-8 位数字,可选 M/F 前缀)。

覆盖范围

  • 覆盖范围: 100%
  • 国家/地区: 阿根廷
  • 服务 ID: arg_renaper
  • 数据领域: 身份
  • 类别: NationalIDRegistry
RENAPER 负责签发所有阿根廷 DNI,因此每个 DNI 号码都有登记记录,包括签发给外国居民的 DNI。人脸比对会将自拍照与 RENAPER 为该 DNI 保存的照片进行比较。

输入

  • 必填输入: document_number、selfie、gender
  • 可选输入: first_name、last_name、date_of_birth、vendor_data
  • 同意: 无需同意
  • 工作流可用性: 可在工作流中使用
  • 覆盖范围: 100%
  • 价格: 每次成功的查询 $0.20

请求体参数

string
默认值:"ARG"
必填
该数据库服务的 ISO 3166-1 alpha-3 国家代码。示例:ARG
string
默认值:"arg_renaper"
必填
包含此服务 ID 的数组。固定服务 ID 可将请求限定在该特定数据库内。示例:arg_renaper
string
默认值:"11111111"
必填
从证件中提取或由用户提供的证件号码。示例:11111111
file
必填
用于生物识别数据库核验的自拍照文件。支持格式:JPEG、PNG 或 WebP。示例:@./selfie.jpg
string
默认值:"M"
必填
性别值(数据库要求时需填写)。允许的值:M(男)、F(女)、X(其他或未知)。示例:M
string
待核验的名字。示例:John
string
待核验的姓氏。示例:Doe
string
出生日期,格式为 YYYY-MM-DD。示例:1990-01-01
string
默认值:"user-1234"
您为该用户提供的稳定用户标识,例如您内部的用户 ID。Didit 使用它将单独的核验关联到同一终端用户,并减少重复检测的干扰。示例:user-1234

输入规则与校验说明

  • 阿根廷 DNI(7-8 位数字,可选 M/F 前缀)
  • document_number 长度必须为 7-9 个字符。
  • document_number 必须匹配 [MFmf]?\d{7,8}。

如何调用

返回数据

source_data 中返回的具体字段取决于登记库返回的内容。arg_renaper 的生成示例目前记录了以下标准化结构:
  • date_of_birth
  • face_match_score
  • first_name
  • full_name
  • identification_number
  • last_name
  • tax_id
  • tax_id_type

定价与 SLA

阿根廷:DNI 验证(RENAPER)查询仅在 Didit 从核验来源收到确定结果时计费。
  • 单次价格: $0.20 USD。
  • 计费方式: 按每次成功的查询计费。当登记库无法访问、缺少必填字段或请求在到达来源前即被拒绝时,不收费。
  • 延迟: 典型 p95 < 2 s。
  • 可用性: Didit 侧每季度为 99.9%;下游来源的可用性因国家和数据集而异。

人脸比对分数

face_match_score 是 RENAPER 对自拍照与 DNI 上留存照片之间的相似度,以字符串形式返回,为 0 到 100 之间的整数,例如 "92"。它不是 0 到 1 之间的概率。 当 RENAPER 报告人脸不匹配,或分数低于 50 时,检查返回 BIOMETRIC_NO_MATCH。分数为 50 或以上时,人脸通过,随后将注册的姓名和出生日期与您提交的数据进行比对。 留存照片可能已有数年,因此真实用户若外貌发生较大变化,分数可能偏低。建议将 BIOMETRIC_NO_MATCH 送交人工审核,而不是直接拒绝,具体请参阅部分匹配 / 无匹配操作。

RENAPER 无响应时

如果无法连接 RENAPER,或其返回错误,结果为 REGISTRY_UNAVAILABLE:未对该人员进行任何核验,且该次调用不计费。稍后重试同一请求可能会成功。处理方法请参阅结果代码。

工作流读取的证件

在工作流中,DNI 号码和性别来自身份证件验证步骤,该步骤读取阿根廷 DNI 卡和电子 DNI。外籍居民持有的同样是 DNI 卡,验证方式相同。 旧版纸质 DNI 小册子(libreta)不属于身份证件验证支持的证件,因此仅持有该证件的用户无法完成该步骤。您仍可直接使用 POST /v3/database-validation/ 核验其 DNI 号码。

在工作流中使用

请在身份证件验证之后,向数据库核验步骤添加该服务。例如,通过 POST /v3/workflows/:
若其前面有活体检测步骤,RENAPER 将比对实时自拍照。若没有,Didit 将改为发送身份证件上印刷的头像。这只能确认证件照片,无法确认镜头前的人就是证件持有人。对于工作流无法运行的服务 ID,会返回包含该 ID 的 400 错误,因此该步骤不会在缺少您所要求的检查的情况下保存。所有数据库核验设置请参阅工作流功能配置。

延伸阅读

最后修改于 2026年11月7日