手机实名认证查询接口规范文档V10

版权所有——华付数据，中国金融大数据领先品牌！手机实名认证接口规范华付数据鉴权中心接口版权所有——华付数据，中国金融大数据领先品牌！文档信息文档版本号V1.0起草人张波起草日期2016/05/26审核人林晓彬审核日期2016/05/28批准人汤红审核日期2016/06/06修订记录版本日期作者说明V1.02016/05/25张波初稿V1.02016/05/28林晓彬定稿本文档中的所有内容为鉴权数据中心的机密和专属所有。未经鉴权数据中心的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。版权所有——华付数据，中国金融大数据领先品牌！目录1概述..................................................................................................................................................42接口介绍..........................................................................................................................................42.1通讯协议.......................................................................................................................................42.2安全协议.......................................................................................................................................42.2.1加解密...................................................................................................................................42.2.2签名方式...............................................................................................................................42.3接入规则.......................................................................................................................................52.3.1IP绑定...................................................................................................................................52.3.2使用范围...............................................................................................................................52.3.3字符编码...............................................................................................................................53手机实名认证接口..........................................................................................................................53.1请求接口地址...............................................................................................................................53.2请求接口.......................................................................................................................................53.3接口返回.......................................................................................................................................73.4错误代码定义...............................................................................................................................8版权所有——华付数据，中国金融大数据领先品牌！1概述手机实名认证数据接口规范文档主要用于制定标准的接口接入准则及流程，指导用户开发人员及测试等相关技术人员快速了解鉴权数据中心提供的数据接口方式和相关规范，并且方便快捷的实现接口对接。2接口介绍2.1通讯协议鉴权数据中心对外数据接口主要以http协议发布2.2安全协议2.2.1加解密鉴权数据中心接口根据主流加解密方法定义了标准统一的加解密方式，DESede进行加解密，即：鉴权数据中心针对用户申请的接口分配唯一的接入秘钥，用户通过所分配的秘钥及任意随机的8位偏移量进行数据加密。Stringdata=allJson.toString();System.out.println(请求报文：+data);//平台分配的唯一的接入秘钥StringprivateKey=l4mdofLTvHkyONpdlyXBiaTv;Stringvector=12345678;//随机8位偏移量StringencrData=Cipher3DES.encrypt(data,privateKey,vector);System.out.println(加密报文：+encrData);2.2.2签名方式接入方对自己加密完成的请求报文字符串进行签名（注意：是加密后再签名），鉴权数据中心提供统一的RSA签名方式，即：用户可在平台在线生成或者自行生成签名密钥对，同时将签名公钥上传至平台，私钥留下自己注意保密，通过生成的签名私钥进行签名，产生签名值。通过平台签名公钥和平台返回签名值进行验签。版权所有——华付数据，中国金融大数据领先品牌！//根据用户自己的签名私钥对加密报文进行签名Stringsignature=RsaSignCoder.sign(encrData,signPrivateKey);System.out.println(签名值：+signature);//根据平台签名公钥对平台返回的加密报文进行验证签名booleanisTrue=RsaSignCoder.verify(datas,signPublicKey,sign);注：具体请参考示例代码2.3接入规则2.3.1IP绑定用户在进行接入的时候需要向鉴权数据中心提供接入服务器的一个或多个公网IP。2.3.2使用范围鉴权数据中心对于敏感数据接口，每次请求需要说明查询原因作为中心留存，用户必须与鉴权数据中心签署数据使用相关责任协议。鉴权数据中心会为每一个接入用户分配唯一的用户编号，用户可使用同一个用户编号申请多个数据接口，但每个接口分别生成不同的密钥进行加解密及签名。注：鉴权数据中心针对一个用户多接口只提供多个加密秘钥，一个签名公钥，本地签名密钥对用户自己生成。2.3.3字符编码鉴权数据中心接口接收和返回统一以UTF-8字符集编码格式进行接收返回3手机实名认证接口3.1请求接口地址请求接口接受参数：版权所有——华付数据，中国金融大数据领先品牌！参数名称参数说明condition请求条件的加密报文userCode平台分配的用户编号signature加密请求报文的签名值vector加密偏移量，用户随机生成8位随机数字或字母条件字段说明：字段名称注释说明请求说明qryBatchNo查询批次号唯一，不超过20位userCode商户编号平台分配的商户编号sysCode应用编号平台创建应用分配的唯一编号qryReason查询原因简单说明调用原由，可为空qryDate查询日期格式：yyyyMMdd，可为空qryTime查询时间格式：hhmmss，可为空realName姓名不超过20位idCard身份证号码正确的身份证号码mobile手机号码正确的手机号码请求条件报文格式：{header:{qryBatchNo:20160525151642123,userCode:TEST10001,sysCode:TESTAPP10001,qryReason:信贷,qryDate:20160526,qryTime:113106},condition:{realName:张三,idCard:43122419871102001X,mobile:[phone]版权所有——华付数据，中国金融大数据领先品牌！}}3.3接口返回返回参数：参数名称参数说明contents返回数据的加密报文signature加密请求报文的签名值正确返回字段说明：字段名称字段说明header报文头name返回数据的名称recordNum返回数据的数量realName姓名idCard身份证号码mobile手机号码resCode认证结果resDesc认证描述正确返回报文格式：{header:{qryBatchNo:20160525151642123,userCode:TEST10001,sysCode:TESTAPP10001,qryReason:信贷,qryDate:20160526,版权所有——华付数据，中国金融大数据领先品牌！qryTime:030322},data:[{name:手机实名认证查询,recordNum:1,record:[{realName:张三,idCard:43122419891102001X,mobile:[phone],resCode:98,resDesc:认证未通过}]}]}错误返回字段说明：字段名称字段说明code错误代码codeDesc错误代码描述错误返回报文格式：{msg:{codeDesc:身份证号码有误,code:02}}3.4错误代码定义错误代码代码描述说明00认证通过版权所有——华付数据，中国金融大数据领先品牌！98认证未通过01姓名校验不通过02身份证号码有误04手机号码不合法10请求条件有缺失，请确认是否遗漏~！20您的体验次数已使用完，请完成正式签约~！30您的签约次数已使用完，请续约购买次数~！44数据渠道已关闭55请求验签失败,请确认加密秘钥和偏移量是否正确~！66未开通该数据渠道77数据渠道已被禁用，暂无限权99交易失败备注:不收费代码：10,20,30,40,44,55,66,77,99其余都收费