法院黑名单个人失信公告信息接口

版权所有©华付数据—中国金融大数据领先平台！法院黑名单个人失信公告信息华付数据鉴权数据中心版权所有©华付数据—中国金融大数据领先平台！QR-29-05法院黑名单个人失信公告信息ii文档信息文档版本号V1.0起草人张波起草日期2016/08/26审核人林晓彬审核日期2016/08/28批准人汤红审核日期2016/09/06修订记录版本日期作者说明V1.02016/08/25张波初稿V1.02016/08/28林晓彬定稿本文档中的所有内容为鉴权数据中心的机密和专属所有。未经鉴权数据中心的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。版权所有©华付数据—中国金融大数据领先平台！QR-29-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字符编码...............................................................................................................................52.4法院黑名单个人失信公告信息请求接口地址...........................................................................52.5请求接口.......................................................................................................................................52.6接口返回.......................................................................................................................................62.7错误代码定义...............................................................................................................................9QR-29-05法院黑名单个人失信公告信息第4页共9页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-29-05法院黑名单个人失信公告信息第5页共9页//根据用户自己的签名私钥对加密报文进行签名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字符集编码格式进行接收返回2.4法院黑名单个人失信公告信息请求接口地址请求接口接受参数：参数名称参数说明condition请求条件的加密报文userCode平台分配的用户编号QR-29-05法院黑名单个人失信公告信息第6页共9页signature加密请求报文的签名值vector加密偏移量，用户随机生成8位随机数字或字母条件字段说明：字段名称注释说明请求说明qryBatchNo查询批次号唯一，不超过20位userCode商户编号平台分配的商户编号sysCode应用编号平台创建应用分配的唯一编号qryReason查询原因简单说明调用原由，可为空qryDate查询日期格式：yyyyMMdd，可为空qryTime查询时间格式：hhmmss，可为空realName姓名不超过20位idCard身份证号码正确的身份证号码请求条件报文格式：{header:{qryBatchNo:20160525151642123,userCode:TEST10001,sysCode:TESTAPP10001,qryReason:信贷,qryDate:20160526,qryTime:113106},condition:{realName:郑华林,idCard:330622196710140716}2.6接口返回QR-29-05法院黑名单个人失信公告信息第7页共9页返回参数：参数名称参数说明contents返回数据的加密报文signature加密请求报文的签名值正确返回字段说明：字段名称字段说明header报文头name返回数据的名称recordNum返回数据的数量realName真实姓名idCard身份证号码documentId失信公告IDsex性别executionInfo被执行人的履行情况caseNumber案号courtName法院province省份resCode结果代码resDesc结果描述正确返回报文格式：{header:{qryBatchNo:20160525151642123,userCode:HFUSER10001,sysCode:APP10001,QR-29-05法院黑名单个人失信公告信息第8页共9页qryReason:信贷,qryDate:20160526,qryTime:030322},data:[{name:个人失信公告记录,recordNum:1,record:[{realName:郑华林,idCard:330622196710140716,resCode:00,resDesc:查询成功}]},{name:个人失信公告信息,recordNum:1,record:[{documentId:1888229@AVb-jToSXsKopr8XLDMS,sex:男,executionInfo:全部未履行,caseNumber:(2015)绍虞执民字第00226号,courtName:上虞市人民法院,province:浙江}]}]}错误返回字段说明：字段名称字段说明code错误代码codeDesc错误代码描述QR-29-05法院黑名单个人失信公告信息第9页共9页错误返回报文格式：{msg:{codeDesc:姓名校验不通过,code:01}}2.7错误代码定义错误代码代码描述说明00查询成功98查无记录01姓名校验不通过02身份证号码有误10请求条件有缺失，请确认是否遗漏20您的体验次数已使用完，请完成正式签约30您的签约次数已使用完，请续约购买次数40您的应用未绑定该数据通道，请确认应用编号是否正确或完成绑定