接口上报操作说明.docx

《接口上报操作说明.docx》由会员分享，可在线阅读，更多相关《接口上报操作说明.docx（8页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

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

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

3、P地址列表，JSON格式步骤二：生成JSON格式数据按照中小企业公共服务平台网络共享数据指标目录和设计 细则（2014版）中编码规则，将单条待上报数据生成对应JSON 格式字符串，该字符串仅可包含一条数据。例如上报一条服务机构数据：（norg_idn: n40288aal0d2f0074an,norg_propertyH: “3，norg_coden: “-X”，norg_namen: ”XX省民营企业合作交流协会”，nlegal_personn: “张三“，Hregister_typeH: “180”,narea_codeH: 110000”，“linkman“ ： “李四”，“tel” ：

4、工fax ：null,“email“ ：website”: null,“address” ：nXX 市 XX 路 11 号 1107-1108”，,postcode1 : 510090”，nindustry_coden: “7211”，nmain_remarkn: ”XX企业合作交流协会是经省民间组织管理局批准于2015年8月合法成 立、具有社会团体法人资格的非盈利社会组织机构。，Mshare_typen: null,nopened_timen: 2015-11”，nregister_assetn: 30, nqualificationH: null, “remark ：null, perso

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

6、String areaCode)String reportServiceOrglnfo (String json, String areaCode)服务机构基本情况String deleteServiceOrglnfo (String json, String areaCodeString reportOrglnfo (String json, String areaCode)服务对象String deleteOrglnfo (String json, String areaCode)String reportOrglnFlat (String json, String areaCode)入驻

7、服务机构String deleteOrglnFlat (String json, String areaCode)String reportServiceltem (String json, String areaCode)服务项目String deleteServiceltem (String json, String areaCode)String reportServiceActivity (String json, String areaCode)服务活动String deleteServiceActivity (String json, String areaCode)String

8、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, 3n,norg_property 取值范围应为1, 2, 3, 5, 9,门。3 .正式表导入出错。产生原因多为数据关联关系缺失，示例: error-1006：地区编码在地区码表中未找到。error编码含义参见中 小企业公共服务平台网络共享数据指标目录和设计细则(2014 版)第八部分错误编码定义，或者登录中小企业服务大数据平台 (),进入帮助中心下载接口上报错误编

10、码定义查看。三、联系人及联系方式.各省市接口上报用户名和初始密码申领：兰鹏 杨易1 .接口调用技术支持：杨易.联系电话：在线上报操作说明一、用户操作建议使用“win7”以上的操作系统，打开浏览器(不支持IE10 以下的浏览器，如果没有IE10+浏览器，请使用360安全浏览器), 在地址栏键入网址：，访问中小企业服务大数据平台。二、服务体系在线上报用户填报说明1 .用户进入系统后，请及时修改用户密码。用户名和初始密 码请咨询各地区省主管。2 .点击页面功能导航中的“当期报送”功能，根据系统提示 完成相关数据上报工作。特别提示：(1)每月日至10日，服务体系用户需要完成数据上报工作;（2）系统每次

11、自动获取上一个报表月份填报的基本情况数据，如果无需修改，填写填报人后，继续下一步操作；（3）每年1月1日至10日需要上报上一年度的服务情况年报;（4）未竣工验收地区的平台网络用户每年1月、4月、7月、10月需要填写平台建设情况季报；（5）每月上报务必点击确认上报操作，报送状态显示待审核, 表示完成了本次上报流程；（6）上报流程图如下：三、省主管用户操作说明1.省主管用户进入系统后，请及时修改用户密码。用户名和初始密码请联系技术支持获取。2 .点击页面功能导航中的“主管部门联系人信息表”，填写 相关联系人信息，以后联系人信息如有变化，请及时更新。3 .点击页面功能导航中的“竣工验收情况”，确认并完善本 地区平台网络竣工验收情况相关信息，如有变化，请及时更新本 地区平台网络竣工验收情况信息。4 .点击页面功能导航中的“在线上报数据审核“，每月15日 之前完成本地区在线上报数据的审核工作。通过审核的上报数据 将上报给国家主管部门，未通过审核的上报数据将退回给在线上 报用户修改后继续上报。5 .每年1月1日至10日，点击页面功能导航中的“服务情况年 度工作总结上报”，请省主管填报本地区服务情况年度工作总结, 点击“确认报送”后，表示完成本次上报工作。6 .请省主管联系服务支持，获取本地区服务体系用户的用户名和初始密码，并下发给相应用户，组织完成数据报送。