身份证二要素核验接口调用教程

2025-07-21

数脉API

身份证二要素核验接口调用教程

身份证二要素核验接口是当前数字身份认证体系的核心组件之一。通过实时校验用户提供的姓名与身份证号码与权威数据库进行是否一致的校验,从而验证身份真实性。身份证二要素核验接口具备毫秒级响应、高并发处理能力及高达99.99%的准确性,广泛应用于用户实名注册、金融风控、政务办理、电商大额交易等场景,能有效防止身份冒用与欺诈行为的发生。

 

 

一、调用流程详解

 

步骤1:选择服务商并获取密钥

数脉API的身份证实名认证为例

注册后完成企业实名认证,选择购买合适的套餐包,获取密钥

 

 

步骤2:构造请求参数

 

 

步骤3:发送请求并处理认证

示例代码:数脉API Python请求

#!/usr/bin/python

# -*- coding: utf-8 -*-

import time

import hashlib

import requests

 

url = "https://api.shumaidata.com/v4/id_card/check"

 

appid = "数脉分配给你的appid"

appsecurity = "数脉分配给你的appsecurity"

timestamp = int(time.time() * 1000)

 

newSign = "{}&{}&{}".format(appid,timestamp,appsecurity)

sign = hashlib.md5(newSign.encode("utf8")).hexdigest()

 

idcard = "身份证号码"

name = "姓名"

 

data = {"appid":appid,"timestamp":timestamp,"sign":sign,"idcard":idcard,"name":name}

 

response = requests.get(url,params=data)

print (response.text)

 

 

步骤4:解析响应结果

`success`:请求结果(true为成功,false为失败,失败情况下,会有对应描述和状态码)

`result`:核验状态(0-一致, 1-不一致, 2-无记录)

`desc`:验证结果描述信息,包含性别、生日、户籍地

 

 

二、常见问题排查(code错误码说明)