验证身份证号和姓名
调用阿里云实人认证 API，验证用户身份证号与姓名是否匹配。
接口地址：POST /verify/verify_id_name
请求头
| 参数名 | 必填 | 说明 |
|---|---|---|
| Content-Type | 是 | 固定值：application/json |
请求参数
| 参数名 | 类型 | 必填 | 格式 | 说明 |
|---|---|---|---|---|
| user_id | string | 是 | 18位字符串 | 用户身份证号 |
| user_name | string | 是 | - | 用户姓名 |
请求示例
{
"user_id": "110***********1234",
"user_name": "示例用户"
}
响应参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| status | int | 是 | HTTP 状态码 |
| id_name_verify_result | bool | 是 | 身份证号和姓名校验结果 |
| code | string | 是 | 校验码和文字结果 |
| result | string | 是 | 校验结论 |
| raw_data | dict | 是 | 阿里云返回的原始数据 |
成功响应示例
{
"status": 200,
"id_name_verify_result": true,
"code": "10000 信息校验完成",
"result": "1 : 信息校验通过",
"raw_data": {
{
"code": "10000",
"message": "成功",
"data": {
"result": "1",
"birthday": "****年**月**日",
"address": "******************",
"sex": "*"
},
"seqNo": "******************"
}
}
}
错误响应示例
接口未开放
{
"status": 403,
"id_name_verify_result": false,
"code": "10017 : 查询失败",
"result": "服务器未开放此接口",
"raw_data": {}
}
身份证格式错误
{
"status": 200,
"id_name_verify_result": false,
"code": "10018 : 参数错误",
"result": "身份证格式错误",
"raw_data": {}
}
姓名格式错误
{
"status": 200,
"id_name_verify_result": false,
"code": "10018 : 参数错误",
"result": "姓名格式错误",
"raw_data": {}
}
姓名和身份证不匹配
{
"status": 200,
"id_name_verify_result": false,
"code": "10000 : 信息校验完成",
"result": "2 : 姓名和身份证不匹配",
"raw_data": {
"code": "10000",
"message": "成功",
"data": {
"result": "2",
"birthday": "****年**月**日",
"address": "******************",
"sex": "*"
},
"seqNo": "******************"
}
}
阿里云 API 查询失败
{
"status": 200,
"id_name_verify_result": false,
"code": "10017 : 查询失败",
"result": "3 : 发生异常",
"raw_data": {
"code": "10017",
"message": "查询失败",
"data": {
"result": "3"
}
}
}
阿里云 API 系统异常
{
"status": 200,
"id_name_verify_result": false,
"code": "10019 : 系统异常",
"result": "3 : 发生异常",
"raw_data": {
"code": "10019",
"message": "系统异常",
"data": {
"result": "3"
}
}
}
请求次数超限
{
"status": 200,
"id_name_verify_result": false,
"code": "10021 : 同一参数请求次数超限",
"result": "3 : 发生异常",
"raw_data": {
"code": "10021",
"message": "同一参数请求次数超限",
"data": {
"result": "3"
}
}
}
警告
此接口需要实名认证权限，当前版本暂未开放。
信息
id_name_verify_result 为 true 时表示身份证和姓名匹配，为 false 时不匹配。
result 字段的格式为 "代码 : 说明"，其中代码 1 表示匹配，2 表示不匹配，3 表示异常。