厦门大学室资源信息管理系统

《厦门大学室资源信息管理系统》由会员上传分享，免费在线阅读，更多相关内容在学术论文-天天文库。

1、厦门大学实验室资源信息管理系统接口说明文档1系统概述厦门大学实验室资源信息管理系统，以下简称“校级平台”，各院级实验仪器管理系统，以下简称“院级系统”。管理单位可以按照统一的数据标准及格式规范，通过接口的方式将报送数据至校级平台。本接口采用REST接口方式，提交与返回的数据为JSON格式，以实现校级平台与各院级系统在数据与服务方面的对接，更加有效地开展实验室资源信息管理服务。本规范适用于各院级系统。校级平台与院级系统共涉及4个接口，具体如下：接口名称用途预约请求接口接收校级平台推送的用户预约请求，返回仪器预约页面仪器数据获取接口接收

2、校级平台推送的仪器信息仪器数据报送接口接收院级系统向校级平台推送仪器信息使用记录上报接口接收院级系统向校级平台推送仪器使用记录接口用户信息接口用于院级系统与校级用户统一认证和管理2接口说明2.1预约请求接口2.1.1接口描述：校级平台通过该接口将预约请求推至院级系统，获取相应院级系统返回的仪器预约页面。2.1.2请求消息参数描述参数名称类型是否为空描述innerIDString否仪器所属单位内部的唯一编码；insCodeString否管理单位的唯一标识；2.1.3响应消息参数描述参数名称类型是否为空描述12页面的地址（url）Str

3、ing否仪器预约页面的url2.1.4接口流程（1）校级系统发布预约仪器服务；（2）用户点击预约按钮，接口将用户的预约请求（仪器所属单位内部编码innerID及单位唯一标识）送至相应的院级系统；（3）院级系统接收到校级平台推送的预约请求，通过在线平台的预约审核流程对预约请求进行审核，根据审核结果并返回具体的仪器预约页面；（4）用户可以在院级系统返回的预约页面中进行仪器预约操作。2.1.5注意事项（1）校级平台统一分配院级单位的唯一标识；（2）校级平台不提供仪器预约服务，只能将用户预约请求推送至院级系统，由院级系统提供具体的仪器预约服

4、务；（3）院级系统返回给校级平台的是具体的仪器与预约页面url，而不是院级系统的首页或其他页面，并且确保预约页面能打开；（4）院级系统返回的预约页面中必须包括该仪器的开放日历及机时安排情况；2.2仪器数据获取接口2.2.1接口描述：院级系统获取校级平台仪器数据的接口。2.2.2请求消息参数描述参数名称类型是否为空描述insCodeString否院级单位的唯一标识instruTypeint否填报数据类型：9仪器信息2.2.3响应消息参数描述参数名称类型是否为空描述状态码int否仪器数据推送结果：100代表成功12101代表数据存取成功

5、，并根据结果提示信息200代表单位编码错误201代表填报数据类型错误202代表推送的数据json字符串格式错误203代表验证数据格式错误204代表其他异常301代表数据库操作异常仪器数据集合List否见2.2.3返回示例说明2.2.3返回示例说明{"status":100,"list":[{"CollegeName":"xxxx",//学院名称"UnitNumber":"2J02",//单位号"SASACClassificationNum":"2400502",//国资分类号"InstrumentChineseNam

6、e":"xxxx",//仪器名称(中文)"InstrumentClassificationNumber":"03052207",//仪器分类号"Model":"MCR302",//型号"Specifications":"MCR302",//规格"UnitPrice":"597916.07",//单价"DateOfProduction":"2013/12/60:00:00",//出厂日期"PurchaseDate":"2013/12/60:00:00",//购置日期"StorageTime":"2014/11/250:00

7、:00",//入库时间"CountryOfOrigin":"xxxx",//生产国别"CountryCode":"156",//国别码"Manufacturer":"xxxx"//生产厂家}]}122.3仪器数据报送接口2.3.1接口描述：院级系统上报校级平台仪器数据的接口。2.3.2请求消息参数描述参数名称类型是否为空描述insCodeString否院级单位的唯一标识instruTypeint否填报数据类型：9仪器信息仪器数据集合List否见仪器数据集合字段说明仪器数据集合字段说明参数名称是否必填参数说明示例参考i

8、sCourtyardNew是是否院级新增仪器0为否1为是CollegeName是学院名称UnitNumber是单位号SASACClassificationNum是国资分类号InstrumentChineseName是仪器名称（中文）I