驾驶证四要素信息认证接口规范文档V10

版权所有©华付数据—中国金融大数据领先平台！驾驶证四要素信息认证接入规范华付数据鉴权数据中心版权所有©华付数据—中国金融大数据领先平台！QR-16-05驾驶证四要素信息认证数据接口规范ii文档信息文档版本号V1.0起草人起草日期2016/08/26审核人审核日期2016/08/28批准人审核日期2016/09/06修订记录版本日期作者说明V1.02016/08/26初稿V1.02016/08/28定稿本文档中的所有内容为鉴权数据中心的机密和专属所有。未经鉴权数据中心的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。版权所有©华付数据—中国金融大数据领先平台！QR-16-05驾驶证四要素信息认证数据接口规范iii目录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请求接口地址（POST）...............................................................................................................53.2请求接口.......................................................................................................................................53.3接口返回.......................................................................................................................................73.4错误代码定义...............................................................................................................................9QR-16-05驾驶证四要素信息认证数据接口规范第4页共10页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签名方式，即：用户可在平台在线生成或者自行生成签名密钥对，同时将签名公钥上传至平台，私钥留下自己注意保密，通过生成的签名私钥进行签名，产生签名值。通过平台签名公钥和平台返回签名值进行验签。QR-16-05驾驶证四要素信息认证数据接口规范第5页共10页//根据用户自己的签名私钥对加密报文进行签名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请求接口地址（POST）请求接口接受参数：参数名称参数说明QR-16-05驾驶证四要素信息认证数据接口规范第6页共10页condition请求条件的加密报文userCode平台分配的用户编号signature加密请求报文的签名值vector加密偏移量，用户随机生成8位随机数字或字母条件字段说明：字段名称注释说明请求说明qryBatchNo查询批次号唯一，不超过20位userCode商户编号平台分配的商户编号sysCode应用编号平台创建应用分配的唯一编号qryReason查询原因简单说明调用原由，可为空qryDate查询日期格式：yyyyMMdd，可为空qryTime查询时间格式：hhmmss，可为空realName姓名不超过20位，可为空driverLicenseNumber驾驶证号码驾驶证号码，不可为空fileNumber档案编号驾驶证档案编号，可为空quasiDrivingType准驾类型驾驶证类型，可为空issueDate初次领证日期可为空birthDate出身日期可为空termValidityStart有效期始可为空termValidityEnd有效期止可为空注：驾驶证必选，其余任选三个。请求条件报文格式：{header:{qryBatchNo:20160525151642123,userCode:TEST10001,QR-16-05驾驶证四要素信息认证数据接口规范第7页共10页sysCode:TESTAPP10001,qryReason:信贷,qryDate:20160526,qryTime:113106},condition:{realName:张三,driverLicenseNumber:4306231992****,quasiDrivingType:C2,issueDate:20160617,fileNumber:,termValidityStart':,termValidityEnd:,birthDate:,}}3.3接口返回返回参数：参数名称参数说明contents返回数据的加密报文signature加密请求报文的签名值正确返回字段说明：字段名称字段说明header报文头name返回数据的名称recordNum返回数据的数量realName姓名driverLicenseNumber驾驶证号码fileNumber档案编号QR-16-05驾驶证四要素信息认证数据接口规范第8页共10页quasiDrivingType准驾类型issueDate初次领证日期birthDate出身日期termValidityStart有效期始termValidityEnd有效期止quasiDrivingType参数的认证结果（0：认证未通过、1：认证通过、-1：当车牌号码不存在，某一个为0，其它为—1）正确返回报文格式：{data:[{name:驾驶证四要素信息认证,recordNum:1,record:[{realName:张三,realNameCode:1,driverLicenseNumber:4306231992****,driverLic