工商信息查询接口V10

版权所有©华付数据—中国金融大数据领先平台！工商信息查询接口规范华付数据鉴权数据中心版权所有©华付数据—中国金融大数据领先平台！QR-17-05工商信息查询接口规范ii文档信息文档版本号V1.0起草人张波起草日期2016/08/06审核人林晓彬审核日期2016/08/08批准人汤红审核日期2016/08/18修订记录版本日期作者说明V1.02016/08/06张波初稿V1.02016/08/18林晓彬定稿本文档中的所有内容为鉴权数据中心的机密和专属所有。未经鉴权数据中心的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。版权所有©华付数据—中国金融大数据领先平台！QR-17-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请求接口地址...............................................................................................................................53.2接口返回.......................................................................................................................................73.3错误代码定义.............................................................................................................................17QR-17-05工商信息查询接口规范第4页共17页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-17-05工商信息查询接口规范第5页共17页//根据用户自己的签名私钥对加密报文进行签名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请求接口地址请求接口接受参数：参数名称参数说明QR-17-05工商信息查询接口规范第6页共17页condition请求条件的加密报文userCode平台分配的用户编号signature加密请求报文的签名值vector加密偏移量，用户随机生成8位随机数字或字母条件字段说明：字段名称注释说明请求说明qryBatchNo查询批次号唯一，不超过20位userCode商户编号平台分配的商户编号sysCode应用编号平台创建应用分配的唯一编号qryReason查询原因简单说明调用原由，可为空qryDate查询日期格式：yyyyMMdd，可为空qryTime查询时间格式：hhmmss，可为空companyName企业全称或者注册号（社会统一信用码）不可为空请求条件报文格式：{header:{qryBatchNo:20160525151642123,userCode:TEST10001,sysCode:TESTAPP10001,qryReason:信贷,qryDate:20160526,qryTime:113106},condition:{companyName:深圳市腾讯计算机系统有限公司}}QR-17-05工商信息查询接口规范第7页共17页3.2接口返回返回参数：参数名称参数说明contents返回数据的加密报文signature加密请求报文的签名值正确返回字段说明：字段名称字段说明header报文头name企业工商信息查询name公司名称econ_kind企业类型regist_capi注册资本scope经营范围term_start营业开始日期term_end营业结束日期belong_org所属工商局oper_name法人check_date核准日期start_date成立日期end_date注销日期status在业状态org_no组织机构号credit_no'统一社会信用代码QR-17-05工商信息查询接口规范第8页共17页province省份缩写reg_no企业注册号address地址main_id企业主要人员记录job_title职位name姓名main_id企业工商信息变更记录change_item变更项目change_date变更日期before_content变更前的内容after_content变更后的内容main_id企业股东记录name股东姓名stock_type股东类型identify_type证件类型identify_no证件号码real_capi_items实缴出资额should_capi_items认缴出资额正确返回报文格式：{data:[QR-17-05工商信息查询接口规范第9页共17页{name:企业工商信息查询,isMainGroup:true,recordNum:1,record:[{resCode:00,resDesc:查询成功,name:深圳市腾讯计算机系统有限公司,econ_kind:有限责任公司,regist_capi:6500万人民币,scope:计算机软、硬件的设计、技术开发、销售（不含专营、专控、专卖商品及限制项目）；数据库及计算机网络服务；国内商业、物资供销业（不含专营、专控、专卖商品）；第二类增值电信业务中的信息服务业务（不含固定网电话信息服务和互联网信息服务，并按许可证B2-20090028号文办）；信息服务业务（仅限互联网信息服务业务，并按许可证粤B2-20090059号文办）；从事广告业务（法律、行政法规规定应进行