姓名与身份证实名认证接口（二要素核验）技术指南
在需要确认用户身份真实性的应用场景中，例如金融开户、实名社交、内容发布审核、在线签约、会员实名认证等，姓名与身份证号码的二要素核验是最基础且关键的环节。该接口提供了一种高效、可靠的方式，直接对接官方权威数据源，实时验证用户提供的姓名和身份证号码是否匹配一致。
接口核心功能
本接口专注于身份证二要素核验服务。开发者只需提交待验证的姓名和身份证号码，接口将实时与官方数据源进行比对校验，并返回核验结果。除了核心的匹配结果外，接口还额外提供该身份证号码对应的生日、性别及籍贯（地址）信息，这些信息来源于身份证号码本身的编码规则（生日、性别）或官方数据库（籍贯）。
接口请求说明
请求方式： POST请求地址： https://www.xujian.tech/atlapi/data/psl/id/check/{code}
注意： {code} 是一个静态参数（请注意保密），需要从微信小程序“数字续坚”的首页签到功能中获取。该 code 是调用接口的必要凭证。
请求头 (Header):
Content-Type: application/json
请求体 (Body - JSON格式):
{
"idcard": "110101199001011234", // 必填，待核验的身份证号码（18位）
"name": "张三" // 必填，待核验的姓名
}
示例如下：
请求参数说明
参数名类型是否必填说明idcardString是需要核验的身份证号码（18位），注意idcard全部是小写字母。nameString是需要核验的姓名。接口响应说明
接口响应统一采用 JSON 格式。响应状态码 (code) 和消息 (msg) 指示请求处理的基本状态，具体核验结果和附加信息包含在 data 对象中。
1. 请求参数错误
当提交的身份证号码格式无效（如长度错误、校验码错误）时，接口返回此错误。
{
"code": 500,
"msg": "身份证号不合法",
"data": null
}
2. 参数正确但核验失败 (姓名与身份证号不匹配)
当身份证号码格式正确，但与提供的姓名在官方数据库中不匹配时，返回此结果。data 对象包含解析出的信息和核验结果。
{
"code": 200,
"msg": "succeed.",
"data": {
"birthday": "19920223", // 从身份证号码中解析出的生日，格式为YYYYMMDD
"result": 1, // 核验结果标识。1 表示：姓名与身份证号不匹配
"address": "重庆市永川区", // 该身份证号码对应的籍贯或地址信息
"orderNo": "202506262330109193435", // 本次核验请求的唯一订单号，可以不管
"sex": "男", // 从身份证号码中解析出的性别（男/女）
"desc": "不一致" // 核验结果描述。"不一致" 表示姓名与身份证号不匹配
}
}
3. 核验成功 (姓名与身份证号匹配)
当姓名与身份证号码在官方数据库中匹配一致时，返回此结果。data 对象包含解析出的信息和核验结果。
{
"code": 200,
"msg": "succeed.",
"data": {
"birthday": "19920223", // 从身份证号码中解析出的生日，格式为YYYYMMDD
"result": 0, // 核验结果标识。0 表示：姓名与身份证号匹配
"address": "重庆市永川区", // 该身份证号码对应的籍贯或地址信息
"orderNo": "202506262320440198227", // 本次核验请求的唯一订单号，用于追踪
"sex": "男", // 从身份证号码中解析出的性别（男/女）
"desc": "一致" // 核验结果描述。"一致" 表示姓名与身份证号匹配
}
}
响应字段 data 对象说明
字段名类型说明birthdayString根据身份证号码第7到14位解析出的出生日期，格式为 YYYYMMDD。resultInt核心核验结果标识。 0：姓名与身份证号匹配； 1：姓名与身份证号不匹配。addressString该身份证号码对应的籍贯或地址信息（通常到区/县级）。orderNoString本次核验请求的唯一订单流水号，可用于查询和问题追踪。sexString根据身份证号码第17位解析出的性别（奇数通常为男，偶数通常为女）。descString对 result 字段的文本描述。"一致" 或 "不一致"。