当前位置:浏览接口 >身份证二要素验证

身份证二要素验证

描述:【身份证实名认证-身份证二要素核验】输入姓名和身份证号,校验此二要素是否一致,同时返回性别、生日和籍贯等信息。广泛应用于信贷、安防、银行、保险等行业及各种身份核查场景。直连官方,实时核验,毫秒级响应,零缓存!

接口地址:https://openapi.chinaz.net/v1/1037/idcard

返回格式:JSON

请求方式:GET|POST

请求参数:

名称 类型 必填 说明
idcardstring身份证号
namestring姓名
APIKeystring申请接口时获取的APIKey值
ChinazVerstring接口版本号,取值:1.0

返回参数说明:

名称 类型 说明
birthdaystring出生日期
ret_codenumber调用状态码,0为成功,其余为失败
sexstring性别:M为男性,F为女性
orderstring相关流水号
countystring区县
addressstring详细地址
provincestring
msgstring调用核验说明
citystring
codenumber验证标示 0:匹配 1:不匹配 2:无此身份证号码 3:身份证号与姓名匹配,照片比对失败 4:参数不能为空 5:四要素匹配成功,照片比对失败 6:四要素匹配失败,照片比对成功 7: 四要素匹配成功,照片异常 12:身份证号码不合法 13: 照片质量异常 14: 姓名异常 15: 暂不支持该地域校验 100:渠道异常,请稍后再试 101:验证信息重复输入,避免恶意验证请间隔60秒以上再次核验 102:维护中 103:24小时内相同姓名或卡号核验次数超限 104:decrypt参数异常 202:姓名加密信息有误,请检查 203:身份证加密信息有误,请检查 205:开始时间加密信息有误,请检查 206:结束时间加密信息有误,请检查 207:人像照片加密信息有误,请检查

JSON返回示例:


{
    "birthday":"1978-10-27",
    "ret_code":0,
    "sex":"M",
    "order":"111111167158948657289183430",
    "address":"北京市 西城区",
    "county":"西城区",
    "province":"北京市",
    "code":0,
    "msg":"匹配",
    "city":"北京市"
}
错误代码说明
0匹配
1不匹配
2无此身份证号码
4参数不能为空
12身份证号码不合法
14姓名异常
15姓名异常
100渠道异常,请稍后再试
101验证信息重复输入,避免恶意验证请间隔60秒以上再次核验
102维护中
10324小时内相同姓名或卡号核验次数超限
431http响应状态码:APIKey缺失,请附带APIKey参数
432http响应状态码:错误的APIkey长度
433http响应状态码:错误的请求key(或者返回状态码10001)
434http响应状态码:错误的APIkey类型
436http响应状态码:额度不足,或者APIKey不存在
437http响应状态码:该IP未在白名单内
531http响应状态码:请求过于频繁
532http响应状态码:未知错误,请联系管理员(或者返回533)
内容说明
客服微信