接口简介:输入身份证号码、姓名、身份证有效期开始日期、身份证有效期截止日期核验返回一致时,包含户籍状态 (0 有效、1 有效 (户籍迁出,但未迁入)、2 无效 (死亡、失踪、迁出、服兵 役、出国境定居、消除重复登记人口、冻结户口、重载注销等));证件最新状态 (1 最新、0 非最新);挂失状态 (1 挂失、0 非挂失);过期状态 (1 过期、0 非过期)等信息,核验不一致时无以上信息
接口地址:https://www.wapi.cn/api_detail/207/387.html
在线核验:https://www.wapi.cn/idcard_four.html
网站地址:https://www.wapi.cn
返回格式:json,xml
请求方式:POST,GET
POST 请求需要设置Header头:Content-Type: application/x-www-form-urlencoded;charset=utf-8
请求说明:
名称 必填 类型 说明 示例参数另存
appid 是 String 应用ID,在后台我的应用查看或者添加 1
bank_end_date 是 String 有效期截止日期:格式:20170606(长期有效身份证填8个0) 20290701
bank_id 是 String 身份证号码 362536199105034456
bank_name 是 String 开户名,即身份证上名字 张三
bank_start_date 是 String 有效期开始日期:格式:20170606 20190701
format 否 String 返回数据格式类型,每个接口已经说明支持返回格式:json,xml, jsonp调用方法说明 json
sign 是 String 1.使用Md5方式验证,参数按一定规则md5后返回的字符串,详情点击这里阅读
2.使用Hash验证方式,直接跟上密钥即可。如何设置hash验证
通过我的应用里面修改验证方式 52a32be274a5c537bbf7a53e2d66c09f
Md5验证方式-加密顺序
sign = MD5( appid1bank_end_date20290701bank_id362536199105034456bank_name张三bank_start_date20190701formatjson密钥) 查看加密规则说明 密钥不需要键名,请直接跟上32位的密钥
红色部分代表参数值,appid默认为1,请修改为自己的appid值,去我的应用查看以及密钥
*注意:空值不参与加密。
返回参数说明:
名称 必填 类型 说明 示例参数另存
bank_area 否 String 归属地 江西省广昌县
bank_attachment 否 Array 验证一致时返回参数。不一致不返回
bank_birthday 否 String 出生日期 1995年04月05日
bank_domicile_status 否 String 户籍状态 (0 有效、1 有效 (户籍迁出,但未迁入)、2 无效 (死亡、失踪、迁出、服兵 役、出国境定居、消除重复登记人口、冻结户口、重载注销等)) 0
bank_expire_status 否 String 过期状态 (1 过期、0 非过期) 0
bank_idCard 否 String 身份证号码 362532199504054263
bank_lost_status 否 String 挂失状态 (1 挂失、0 非挂失) 0
bank_msg 否 String 消息说明 验证通过
bank_name 是 String 开户名,即身份证上名字 李明
bank_new_status 否 String 证件最新状态 (1 最新、0 非最新) 1
bank_sex 否 String 性别 男
bank_status 否 String 返回的状态码,详情点击这里查看 01
codeid 否 Integer 状态码,返回10000状态都会进行计费。具体说明可查看状态码说明 10000
message 否 String 请求状态说明 通过
retdata 否 Array 回数据集合,可能是数据、对象或者字符串
time 否 String 请求时传递的当前服务器时间戳 1577695766
JSON返回示例:
树 ▾
object►retdata►
object {4}
codeid : 10000
message : 通过
retdata {8}
bank_status : 01
bank_msg : 验证通过
bank_idCard : 362532199504054263
bank_name : 李明
bank_sex : 男
bank_area : 江西省广昌县
bank_birthday : 1995年04月05日
bank_attachment {4}
time : 1577695766