企业基本信息验证接口技术文档

企业基本信息验证接口技术文档2017年11月30日目录1 概述12 接口信息22.1 接口认证22.1.1 参数说明23 接口规范33.1 接口输入规范33.1.1 参数格式33.1.2 参数说明33.1.3 入参规则43.2 接口返回规范53.2.1 返回格式53.2.2 结果说明54 完整示例61 概述本接口提供企业照面信息比对验证服务，通过输入企业照面相关信息，其中企业名称和统一社会信用代码至少输入一项，其他比对字段可选。比对结果包括输入条件、比对企业登记状态、比对结果、比对差异详细等内容。2 接口信息接口类型：RESTful WebService接口权限：HTTP Basic Authentication接口方法：POST接口格式：JSON接口编码：UTF-8接口地址：01/rest_gszj_qyjbxxyz_cz2.1 接口认证在请求header中需要填充认证信息。2.1.1 参数说明Header中所需的参数如下表：参数名称参数说明gjgxjhpt_rid请求方标识 （请求者标识）gjgxjhpt_sid请求服务标识（接口编码）gjgxjhpt_rtime程序生成 当前调用时间戳gjgxjhpt_sign对应认证环节最后获得的sign。注意这个sign生成之后五分钟有效期。AuthorizationBasic Z3hzZDAxOjY2NjY2Ng=(此项为固定值)上述参数中，除Authorization为固定值，其余参数需要实时生成，具体生成方法请参考国家共享平台接口认证方式说明文档.docx。3 接口规范3.1 接口输入规范3.1.1 参数格式entname:xxxxxxxxx公司,uniscid:UXxxxxxx9,regno:65xxxxxx,enttypeCn:公司,regcap:1x,regcapcurCn:人民币,estdate:1511322208,apprdate:1511322208,regstateCn:在营,regorgCn:xxxx工商所,opfrom:1511322208,opto:1511322208,dom:xx省xx市xxxxxxxx,name:王xx,opscope:xxxxxx,xxxxxxx3.1.2 参数说明entname主体名称uniscid统一社会信用代码regno注册号enttypeCn企业类型(中文)regcap注册资本regcapcurCn注册资本币种estdate成立日期apprdate核准日期regstateCn登记状态(中文)regorgCn登记机关(中文)opfrom经营期限自opto经营期限至dom住所name法定代表人opscope经营范围3.1.3 入参规则接口调用时需要严格按照3.1.1中参数格式入参，其中entname和uniscid至少输入一项，其他项均为选填，不填写以及填写空均不进入比对范围。不允许输入上述数据项以外的其他数据项。3.2 接口返回规范3.2.1 返回格式 ent_idx: entname: xxxxxx公司, uniscid: Gxxxxxx67,regstateCn: 吊销,未注销, entchk_checkres_key: 0x, diff_list: chk_key: regno, in_val: 666xxxxxx, out_val: 652xxxxxx , chk_key: enttypeCn, in_val: xxxx公司, out_val: xx有限责任公司 , _map_: true3.2.2 结果说明ent_idx：接口输入的企业名称和统一社会信用代码regstateCn：企业登记状态entchk_checkres_key校验结果代码：01：未查询到主体02：输入的企业名称和统一社会信用代码存在歧义03：比对后完全一致04：比对后存在不一致05：输入参数需要满足必填参数规则06：查询过程出现错误diff_list比对不一致数据项列表，其中chk_key为比对数据项，in_val为输入值，out_val为输出值。4 完整示例使用postman工具调试，以post方式发送json请求，获取接口返回值。Headers部分