西班牙DNI/NIE验证API：实时身份核查 (ZH)

在西班牙招募用户意味着要确认其身份真实性。Didit通过对照西班牙国家警察总局的记录来验证西班牙DNI/NIE。一份文件或手动输入的数据只能证明数据存在，而不能证明其真实性或属于您面前的人。西班牙DNI/NIE验证通过对照该国官方政府身份登记系统来弥补这一空白。本指南将解释此项检查的功能、具体技术细节以及如何在几分钟内完成集成。

主要内容：

• 检查内容 — 西班牙DNI/NIE验证对照该国官方政府身份登记系统验证国民身份证件。
• 返回结果 — 标准化的match_type以及字段级结果，您可以直接将其导入批准/审查/拒绝逻辑。
• 重要性 — 文件可能被伪造；登记记录则不能。对照权威政府来源验证身份证件可确认持有人真实且身份正确。
• 使用方法 — 向Didit的数据库验证端点发送一次POST请求，或使用无代码工作流模块。每次确凿查询费用为0.20美元，几秒内即可获得结果。

西班牙DNI/NIE验证内容

Didit通过单个端点对照西班牙国家警察总局的记录验证西班牙DNI/NIE，以便您对照该国官方政府身份登记系统验证提交的数据，并接收结构化、标准化的结果——而不是您需要自行解析的原始登记数据。

确凿响应会返回匹配的source_data和一个字段级别的validation块，以便您的风险引擎获得清晰、机器可读的判断。

重要性

文件可能被伪造；登记记录则不能。对照权威政府来源验证身份证件可确认持有人真实且身份正确。

对于西班牙的受监管企业——金融科技公司、加密货币平台、贷款机构、市场平台和游戏运营商——对照权威来源进行检查可生成可辩护、可审计的记录，证明身份是在源头确认的，而不仅仅是从表格或照片中获取的。

技术细节

Didit通过统一的数据库验证端点提供此服务。它是一个单独的POST请求——无需SDK。

端点

POST /v3/database-validation/

请求参数

参数	类型	必需	描述
issuing_state	字符串	是	ISO 3166-1 alpha-3 国家代码。使用ESP。
services	字符串	是	服务标识符。使用esp_dni。
personal_number	字符串	是	个人号码。
document_type	字符串	是	证件类型。
expiration_date	字符串	是	有效期。
first_name	字符串	否	名（可选交叉检查）。
last_name	字符串	否	姓（可选交叉检查）。

请求示例

curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ESP" \
  -F "services=esp_dni" \
  -F "personal_number=1111111" \
  -F "document_type=sample_value" \
  -F "expiration_date=1990-01-01"

响应示例（确凿匹配）

{
  "request_id": "req_01H...",
  "status": "Approved",
  "issuing_state": "ESP",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "esp_dni",
      "service_name": "Spain - DNI/NIE verification",
      "source_data": {
        "document_type": "sample_value",
        "expiration_date": "1990-01-01",
        "first_name": "John",
        "full_name": "John Doe",
        "identification_number": "SAMPLE-ID-12345",
        "last_name": "Doe"
      },
      "validation": {
        "full_name": "full_match",
        "identification_number": "full_match"
      }
    }
  ]
}

性能和计费

• 延迟：通常几秒钟。
• 费用：每次确凿查询0.20美元。您只对确凿结果付费——源系统停机、缺少字段或源系统预拒绝不收费。
• 可靠性：运行在Didit的基础设施上，季度正常运行时间目标为99.9%。

用例

• 金融科技和数字银行 — 在西班牙开设钱包或提供信贷之前，确认账户持有人真实且可验证。
• 加密货币和Web3 — 通过权威来源的身份证明，满足VASP的入职要求。
• 贷款 — 通过源验证数据减少合成身份欺诈和第一方欺诈。
• 市场和零工平台 — 对照权威数据验证用户，而不仅仅是自报的表格。
• iGaming — 通过可审计的记录，满足西班牙玩家的身份和资格检查。

如何与Didit集成

您可以通过两种方式运行西班牙DNI/NIE验证：

1. 无代码工作流。在Didit商务控制台中，打开工作流构建器，添加数据库验证模块，选择西班牙 → 西班牙DNI/NIE验证，然后激活它。匹配的用户将自动路由——无需工程开发。
2. 直接API。使用services=esp_dni调用上面显示的/v3/database-validation/端点。读取match_type和字段级别的validation块以驱动您的批准/审查/拒绝逻辑。

每个Didit账户每月包含500次免费验证，因此您可以在支付任何查询费用之前测试完整的端到端流程。

常见问题

西班牙DNI/NIE验证检查确认了什么？

它对照该国官方政府身份登记系统验证提交的数据，并返回标准化的匹配结果，因此您可以了解国民身份证件是否存在于权威来源以及哪些字段匹配。

如果源系统暂时不可用会发生什么？

您不会被收费。计费仅适用于确凿结果——源系统停机、缺少字段和源系统预拒绝是免费的。

检查速度有多快？

数据库验证通常在几秒钟内返回，因此它适用于实时入职流程。

我需要SDK吗？

不需要。该检查是对一个端点的单个HTTPS POST请求。您也可以将其连接到商务控制台中的无代码工作流。

准备好开始了吗？

立即验证您的第一个西班牙国民身份证件。

• 阅读API参考： 西班牙DNI/NIE验证
• 查看所有数据库验证： 数据库验证定价和覆盖范围
• 开始构建： 创建免费的Didit账户 — 每月500次免费验证。