当前位置: 首页 > api商店 > 身份证四要素核验Api接口详情
身份证四要素核验

商务合作

*关于产品有效期*
  • 首次赠送0次
  • 2001.2/次
  • 10001/次
  • 50000.9/次
  • 100000.8/次
  • 随心搭

价格: (约元/次)

立即添加 在线使用
接口简介:输入身份证号码、姓名、身份证有效期开始日期、身份证有效期截止日期核验返回一致时,包含户籍状态 (0 有效、1 有效 (户籍迁出,但未迁入)、2 无效 (死亡、失踪、迁出、服兵 役、出国境定居、消除重复登记人口、冻结户口、重载注销等));证件最新状态 (1 最新、0 非最新);挂失状态 (1 挂失、0 非挂失);过期状态 (1 过期、0 非过期)等信息,核验不一致时无以上信息
  • Api文档
  • 状态码说明
  • Demo示例
手机号机主姓名核验

接口地址: https://登录后显示/pyi/207/387(支持:http/https)

返回格式:json,xml,jsonp调用

请求方式:GET,POST

POST 请求需要设置Header头:Content-Type: application/x-www-form-urlencoded;charset=utf-8

Api测试工具

请求说明:

名称 必填 类型 说明 示例 参数另存
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 出生日期 *****
bank_domicile_status String 户籍状态 (0 有效、1 有效 (户籍迁出,但未迁入)、2 无效 (死亡、失踪、迁出、服兵 役、出国境定居、消除重复登记人口、冻结户口、重载注销等)) 0
bank_expire_status String 过期状态 (1 过期、0 非过期) 0
bank_idCard String 身份证号码 *****
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返回示例:

服务器状态码:

状态码 说明
10000 返回成功
10001 appid必须指定,可以我的应用里面查看
10002 sign值必须指定,加密规则请前往帮助中心查看
10003 sign值验证不通过,加密规则请前往帮助中心查看
10004 时差不能超过10分钟,可以不传递这个参数,注意时间戳单位是秒
10005 appid错误,请检查appid值,前往会员中心->我的应用查看或添加
10006 当前IP地址未授权,请前往用户中心->我的应用添加ip{@info}
10007 应用被禁用,请联系客服处理
10008 应用内没有该接口,请到我的应用里面添加这个接口
10009 api接口不存在
10010 您没有添加该api接口
10011 api已经到期
10012 没有订购任何api,请前往购买后再操作
10013 该接口已经暂停使用
10014 未知的错误,可以联系客服处理
10015 参数个数错误
10019 {@info}
10017 time必须是整型
10018 次数不足
10020 子接口不存在,可能已经被关闭
10021 服务器发生错误
10022 帐户余额不足,请充值!
10023 订单提交成功,等待回调结果
10024 调试模式数据
10025 查无数据

请选择下载文件开发语言:(部分文件格式浏览器可能提示风险或者屏蔽)