国家网络管理平台接口说明文档-福建省大型科研设施仪器管理服务平台.DOC

PAGE PAGE 1 国家网络管理平台接口说明文档 1系统概述 依据《国务院关于国家重大科研基础设施和大型科研仪器向社会开放的意见》，为保证科研设施与仪器管理单位（以下称管理单位）能够及时、准确地将科研设施与仪器和运行服务记录等数据信息报送至科研设施与仪器国家网络管理平台（以下称“国家网络管理平台”）。除仪器信息的单条录入、批量导入、数据远程抓取等方式外，管理单位可以按照统一的数据标准及格式规范，通过接口的方式将报送数据至国家网络管理平台。 本接口基于HTTP协议，使用WebService技术开发，以实现国家网络管理平台与管理单位在线服务平台在数据与服务方面的对接，提高仪器数据上报的效率为目的，更加有效地开展仪器的共享服务。 本规范适用于管理单位在线服务平台。 国家网络管理平台与管理单位在线服务平台共涉及4个接口，具体如下： 接口名称 用途 承担方 预约请求接口 接收国家网络管理平台推送的用户预约请求，返回仪器预约页面 管理单位在线服务平台 订单查询接口 接收国家网络管理平台推送的用户订单请求，返回该用户涉及的所有订单信息 管理单位在线服务平台 订单详情接口 接收国家网络管理平台推送的用户订单查询请求，返回该订单的详细页面 管理单位在线服务平台 仪器数据报送接口 接收管理单位在线服务平台向国家网络管理平台推送仪四大类仪器信息、海关监管记录及共享服务记录 国家网络管理平台 服务成效接口 接收管理单位在线服务平台向国家网络管理平台推送仪器的服务成效 国家网络管理平台 用户信息接口 用于在线服务平台与国家网络管理的用户统一认证和管理 国家网络管理平台 2接口说明 在线服务平台开发的接口： 2.1预约请求接口 2.1.1接口描述：国家网络管理平台通过该接口将预约请求推至在线服务平台，获取相应在线服务平台返回的仪器预约页面。 2.1.2请求消息参数描述 参数名称 类型 是否为空 描述 innerId String 否 仪器所属单位内部的唯一编码； insCode String 否 管理单位的唯一标识； 2.1.3响应消息参数描述 参数名称 类型 是否为空 描述 页面的地址（url） String 否 仪器预约页面的url 2.1.4接口流程 在线服务平台发布预约仪器服务； 用户点击预约按钮，接口将用户的预约请求（仪器所属单位内部编码innerID及单位唯一标识）送至相应的在线服务平台； 在线服务平台接收到国家网络管理平台推送的预约请求，通过在线平台的预约审核流程对预约请求进行审核，根据审核结果并返回具体的仪器预约页面； 用户可以在在线服务平台返回的预约页面中进行仪器预约操作。 2.1.5注意事项 国家管理平台统一分配管理单位的唯一标识； 国家网络管理平台不提供仪器预约服务，只能将用户预约请求推送至在线服务平台，由在线服务平台提供具体的仪器预约服务； 在线服务平台返回给国家网络管理平台的是具体的仪器与预约页面url，而不是在线服务平台的首页或其他页面，并且确保预约页面能打开； 在线服务平台返回的预约页面中必须包括该仪器的开放日历及机时安排情况； 2.2订单查询接口 2.2.1接口描述：国家网络管理平台通过该接口将用户的查询请求推至在线服务平台，获取用户在相应的在线服务平台预约成功的所有订单数据。 2.2.2请求消息参数描述 参数名称 类型 是否为空 描述 userName String 否 国家管理平台用户名，用户的唯一标识； 2.2.3响应消息参数描述 参数名称 类型 是否为空 描述 用户的订单数据 ListString 否 国家管理平台的用户在在线服务平台进行仪器预约形成的订单数据的集合； 实例请参考见附录1中的订单查询示例 2.2.4接口流程 （1）在线服务平台发布订单查询服务； （2）用户想要查询在管理单位的在线服务平台的预约成功的订单情况，调用该接口将用户的查询请求（国家管理平台用户名）送至相应的在线服务平台； （3）在线服务平台接收到国家网络管理平台推送的查询请求，通过在线平台的审核流程对查询请求进行审核，根据审核结果并返回订单数据； （4）用户可以在在线服务平台返回的订单数据中进行订单的详情查看操作。 2.2.5注意事项 （1）国家管理平台用户名，是用户的唯一标识； （2）国家网络管理平台不提供仪器订单服务，只能将用户订单查询请求推送至在线服务平台，由在线服务平台提供相关的订单数据； （3）在线服务平台返回给国家网络管理平台的是该用户的仪器预约的订单数据，而不是在线服务平台的其他用户的订单信息，并且确保订单数据真实有效； （4）订单的数据查询为实时查询，在线服务平台应保证用户的实时查询效率。订单的数据状态，具体根据各在线服务平台订单状态数据为准。 2.3订单详情接口 2.3.1接口描述：国家网络管理平台通