附件5：中小企业服务大数据平台接口上报操作说明.doc

《附件5：中小企业服务大数据平台接口上报操作说明.doc》由会员分享，可在线阅读，更多相关《附件5：中小企业服务大数据平台接口上报操作说明.doc（5页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、附件5接口上报操作说明 一、接口地址 接口采用WebService技术实现，地址如下： 二、实施步骤 步骤一：报备上报服务器IP地址 省中小企业服务中心调用接口需要检查上报服务器IP地址是否合法，验证通过规则为当前报送平台合法IP地址列表中包含当前上报IP地址，不合法则禁止本次数据上报。 省中小企业服务中心可调用以下接口方法维护本平台的合法IP地址列表，调用接口的用户名和密码请联系技术支持人员申领。l 报备IP地址方法：int addIP(String userId, String password, String IP)参数说明：参数名说明userId用户名password密码IP地址IP地

2、址返回值说明：返回值说明1注册成功-1用户名密码不正确-2账号已被禁用-3IP地址已存在l 删除IP地址方法：int delIP(String userId, String password, String IPCsv)参数说明：参数名说明userId用户名password密码IPCsv欲删除的IP地址列表，格式为英文逗号分隔符返回值说明：返回值说明1删除成功-1用户名密码不正确-2账号已被禁用l 获取合法IP地址列表方法：String getIP(String userId, String password)参数说明：参数名说明userId用户名password密码返回值示例说明：返回值示例

3、说明192.168.0.1,192.168.0.2用户合法IP地址列表，JSON格式 步骤二：生成JSON格式数据 按照中小企业公共服务平台网络共享数据指标目录和设计细则（2014版）中编码规则，将单条待上报数据生成对应JSON格式字符串，该字符串仅可包含一条数据。 例如上报一条服务机构数据：org_id : 40288a0201439a10d2f0074a,org_property : 3,org_code : 12345678-X,org_name : XX省民营企业合作交流协会,legal_person : 张三,register_type : 180,area_code : 11000

4、0,linkman : 李四,tel : 010-12345678,fax : null,email : test, website : null,address : XX市XX路11号1107-1108,postcode : 510090,industry_code : 7211,main_remark : XX企业合作交流协会是经省民间组织管理局批准于2015年8月合法成立、具有社会团体法人资格的非盈利社会组织机构。,share_type : null,opened_time : 2015-11,register_asset : 30,qualification : null,remark

5、 : null,personnel : null,photo : , org_grade : null, from_url : 步骤三：调用接口上报方法上报数据 上报数据的接口方法共7个，分别对应7张基本数据表。根据步骤二中待上报数据所属的数据表，调用对应的数据表接口方法，reportXxx为新增或修改方法（具体操作由接口自行判断），deleteXxx为删除方法，方法名与数据表对应关系如下表所示。方法数据表String reportFlatInfo(String json, String areaCode)省平台、窗口平台基本情况String deleteFlatInfo(String jso

6、n, String areaCode)String reportServiceOrgInfo (String json, String areaCode)服务机构基本情况String deleteServiceOrgInfo (String json, String areaCodeString reportOrgInfo (String json, String areaCode)服务对象String deleteOrgInfo (String json, String areaCode)String reportOrgInFlat (String json, String areaCode

7、)入驻服务机构String deleteOrgInFlat (String json, String areaCode)String reportServiceItem (String json, String areaCode)服务项目String deleteServiceItem (String json, String areaCode)String reportServiceActivity (String json, String areaCode)服务活动String deleteServiceActivity (String json, String areaCode)Stri

8、ng reportServiceCredit (String json, String areaCode)服务过程及服务评价String deleteServiceCredit (String json, String areaCode) 所有方法的json参数为步骤二生成的JSON格式数据，areaCode参数为地方平台6位地区编码。 步骤四：接收接口返回上报结果 中小企业服务大数据平台对采集到的数据进行实时处理。 经过上报服务器IP验证，数据格式校验、数据间关联关系检查，数据入库等处理后，将本次上报结果返回给地方平台。上报成功返回结果为空字符串。 若发生异常会根据异常发生时的处理环节产生以

9、下三类异常日志信息： 1.当前报送IP地址非法。需要添加当前IP地址进入合法IP列表才能使用当前IP地址报送。 2.临时表导入出错。产生原因多为数据格式错误，日志信息为JSON格式字符串，示例：flat_type取值范围应为1, 2, 3,org_property取值范围应为1, 2, 3, 5, 9, 。 3.正式表导入出错。产生原因多为数据关联关系缺失，示例：error-1006：地区编码在地区码表中未找到。error编码含义参见中小企业公共服务平台网络共享数据指标目录和设计细则（2014版）第八部分错误编码定义，或者登录中小企业服务大数据平台（），进入帮助中心下载接口上报错误编码定义查看。 三、联系人及联系方式 1、接口调用技术支持：杨易 2、联系电话：010-685949075