跳转到主要内容
POST
通过全球风险洞察网络,根据电子邮件和/或电话号码解析个人信息(姓名、出生日期、地址、电话号码、电子邮件和国民身份号码)以及姓名匹配分数。按请求计费。Didit 通过 POST /v3/database-validation/ 提供此服务,以便您将提交的数据与所连接的身份网络进行筛查,并获得标准化的匹配结果。这是第三方信息补充网络,而不是权威的政府登记库,请勿将其结果呈现为一手来源的核验结果。

覆盖范围

  • 覆盖范围: 50+ 个市场
  • 国家/地区: 全球
  • 服务 ID: glb_identity_enrichment
  • 数据领域: 身份
  • 类别: IdentityEnrichment

输入

  • 必填输入: —
  • 可选输入: email、phone、first_name、last_name、full_name、country_of_residence、vendor_data
  • 同意: 必需
  • 工作流可用性: 仅限独立 API
  • 覆盖范围: 50+ 个市场
  • 价格: 每次成功查询 $0.20
此服务不作为工作流中的数据库核验步骤提供。这限制的是检查的运行位置,而不是您可以发送的内容:请在独立 API 上调用,由您直接提供输入。

请求体参数

string
默认值:"GLB"
必填
此数据库服务的 ISO 3166-1 alpha-3 国家/地区代码。示例:GLB
string
默认值:"glb_identity_enrichment"
必填
包含此服务 ID 的数组。固定服务可使请求仅限于此特定数据库。示例:glb_identity_enrichment
终端用户对此服务的明确同意。示例:true
string
默认值:"john.doe@example.com"
电子邮件地址。示例:john.doe@example.com
string
默认值:"+15550101000"
国际格式的电话号码。示例:+15550101000
string
默认值:"John"
需要核验的名字。示例:John
string
默认值:"Doe"
需要核验的姓氏。示例:Doe
string
需要核验的完整法定姓名。示例:John Doe
string
默认值:"US"
可选的 ISO 3166-1 alpha-2 居住国家/地区代码。仅用于缩小身份查询范围。示例:US
string
默认值:"user-1234"
您为该用户提供的稳定用户标识,例如您内部的用户 ID。Didit 使用它将独立检查关联到同一终端用户,并减少重复检测的干扰。示例:user-1234

输入规则与验证说明

  • 至少提供 email 或 phone 之一,它们是查询的关键字段。两者都未提供的请求无法执行信息补充查询,会在查询数据源之前被拒绝(不收费)。
  • 只要有姓名,就请添加:数据源会根据姓名为查询评分。请发送 first_name 和 last_name,它们是响应中 validation 映射所比对的字段。仅发送 full_name 的请求仍会由数据源评分,但返回的 validation 为空,且顶层 match_type 为 null。
  • country_of_residence 是用于缩小查询范围的 ISO 3166-1 alpha-2 国家/地区代码。
  • 每次完成的查询都会计费,包括未解析出任何人员的查询(persons_found: 0)。只有在查询前被拒绝的请求(既未提供 email 也未提供 phone)才免费。

调用方式

返回数据

source_data 中实际返回的字段取决于注册库返回的内容。glb_identity_enrichment 的自动生成示例目前记录了以下标准化结构:
  • first_name
  • last_name
  • persons_found

定价与 SLA

全球 - 身份信息增强查询仅在 Didit 从验证数据源收到明确结果时计费。
  • 单次调用价格: $0.20 USD。
  • 计费方式: 按每次成功查询计费。注册库无法访问、必填字段缺失,或请求在到达数据源前即被拒绝时,不收取费用。
  • 延迟: 典型 p95 延迟小于 2 秒。
  • 可用性: Didit 侧每季度 99.9%;下游数据源的可用性因国家和数据集而异。

继续阅读

最后修改于 2026年11月7日