厦门大学实验室资源信息管理系统.docVIP

厦门大学实验室资源信息管理系统 接口说明文档 1系统概述 厦门大学实验室资源信息管理系统，以下简称“校级平台”，各院级实验仪器管理系统，以下简称“院级系统”。管理单位可以按照统一的数据标准及格式规范，通过接口的方式将报送数据至校级平台。 本接口采用REST接口方式，提交与返回的数据为JSON格式，以实现校级平台与各院级系统在数据与服务方面的对接，更加有效地开展实验室资源信息管理服务。 本规范适用于各院级系统。 校级平台与院级系统共涉及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请求消息参数描述 参数名称 类型 是否为空 描述 insCode String 否 院级单位的唯一标识 instruType int 否 填报数据类型： 9 仪器信息 2.2.3响应消息参数描述 参数名称 类型 是否为空 描述 状态码 int 否 仪器数据推送结果： 100代表成功 101代表数据存取成功，并根据结果提示信息 200代表单位编码错误 201代表填报数据类型错误 202代表推送的数据json字符串格式错误 203代表验证数据格式错误 204代表其他异常 301代表数据库操作异常 仪器数据集合 ListString 否 见2.2.3返回示例说明 2.2.3返回示例说明 {status:100, list:[ { CollegeName:xxxx,//学院名称 UnitNumber:2J02,//单位号 SASACClassificationNum:2400502,//国资分类号 InstrumentChineseName:xxxx,//仪器名称(中文) InstrumentClassificationNumber//仪器分类号 Model:MCR302,//型号 Specifications:MCR302,//规格 UnitPrice:597916.07,//单价 DateOfProduction:2013\/12\/6 0:00:00,//出厂日期 PurchaseDate:2013\/12\/6 0:00:00,//购置日期 StorageTime:2014\/11\/25 0:00:00,//入库时间 CountryOfOrigin:xxxx,//生产国别 CountryCode:156,//国别码 Manufacturer:xxxx//生产厂家 } ] } 2.3仪器数据报送接口 2.3.1接口描述：院级系统上报校级平台仪器数据的接口。 2.3.2请求消息参数描述 参数名称 类型 是否为空 描述 insCode String 否 院级单位的唯一标识 instruType int 否 填报数据类型： 9 仪器信息 仪器数据集合 ListString 否 见仪器数据集合字段说明 仪器数据集合字段说明 参数名称 是否必填 参数说明 示例参考 isCourtyardNew 是 是否院级新增仪器 0为否 1为是 Col