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

接口说明文档

1系统概述

厦门大学实验室资源信息管理系统，以下简称“校级平台”，各院级实验仪器管理系统，以下简称“院级系统”。管理单位可以按照统一的数据标准及格式规范，通过接口的方式将报送数据至校级平台。

本接口采用REST接口方式，提交与返回的数据为JSON格式，以实现校级平台与各院级系统在数据与服务方面的对接，更加有效地开展实验室资源信息管理服务。

本规范适用于各院级系统。

校级平台与院级系统共涉及4个接口，具体如下：

2接口说明

预约请求接口

接口描述：校级平台通过该接口将预约请求推至院级系统，获取相应院级系统返回的仪器预约页面。

请求消息参数描述

响应消息参数描述

接口流程

（1）校级系统发布预约仪器服务；

（2）用户点击预约按钮，接口将用户的预约请求（仪器所属单位内部编码innerID及单位唯一标识）送至相应的院级系统；

（3）院级系统接收到校级平台推送的预约请求，通过在线平台的预约审核流程对预约请求进行审核，根据审核结果并返回具体的仪器预约页面；

（4）用户可以在院级系统返回的预约页面中进行仪器预约操作。

注意事项

（1）校级平台统一分配院级单位的唯一标识；

（2）校级平台不提供仪器预约服务，只能将用户预约请求推送至院级系统，由院级系统提供具体的仪器预约服务；

（3）院级系统返回给校级平台的是具体的仪器与预约页面url，而不是院级系统的首页或其他页面，并且确保预约页面能打开；

（4）院级系统返回的预约页面中必须包括该仪器的开放日历及机时安排情况；

仪器数据获取接口

接口描述：院级系统获取校级平台仪器数据的接口。

请求消息参数描述

响应消息参数描述

返回示例说明

{"status":100,

"list":[

{

"CollegeName":"xxxx",//学院名称

"UnitNumber":"2J02",//单位号

"SASACClassificationNum":"2400502",//国资分类号

"InstrumentChineseName":"xxxx",//仪器名称(中文)

"InstrumentClassificationNumber":"03052207",//仪器分类号

"Model":"MCR302",//型号

"Specifications":"MCR302",//规格

"UnitPrice":"",//单价

"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"//生产厂家

}

]

}

仪器数据报送接口

接口描述：院级系统上报校级平台仪器数据的接口。

请求消息参数描述

仪器数据集合字段说明

响应消息参数描述

接口流程

（1）校级平台发布仪器数据报送服务；

（2）院级系统通过该接口推送仪器数据至校级平台；

（3）校级平台验证单位唯一标识和仪器类别的正确性；验证失败则返回相应状态码；

（4）校级平台对上报的仪器数据进行验证，验证通过进行数据库存储，已报过的数据则进行更新；验证失败返回相应状态码；

注意事项

（1）院级系统通过接口报送的数据格式按照附录1中仪器数据报送接口的各类型仪器示例。

（2）校级平台统一分配院级单位的唯一标识；院级单位可登录校级平台查看本单位的唯一标识，院级系统需保存单位标识关联表；

（3）管理单位院级系统需将平台负责人的通讯邮箱上报校级平台；校级平台对数据验证的错误信息会以邮件的方式发送院级系统负责人的邮箱；

（4）院级系统接与校级平台的对接过程中，如果多次出现错误状态码，及时联系相关人员。

仪器使用记录接口

接口描述：院级系统将仪器使用记录数据上报到校级平台的接口。

请求消息参数描述

使用记录的集合字段说明

响应消息参数描述

接口流程

（1）校级贵重仪器设备管理系统根据从各学院抓取的仪器设备使用情况数据作为计费数量的依据；

（2）院级系统调用该接口将单位的仪器设备使用情况数据推送至校级平台；

（3）校级平台首先验证单位唯一标识的正确性，验证通过则获取仪器设备使用情况数据；验证失败则返回相应的状态码；

（4）校级平台将上报的仪器设备使用情况数据进行验证，验证通过则保存到数据库中，验证失败则返回相应的状态码；

注意事项

（1）院级系统通过该接口报送的仪器设备使用情况数据按照附录1中的仪器使用记录接口的示例。

（2）校级平台统一分配院级单位的唯一标识；院级系统需保存单位标识关联表；院级单位可登录校级平台查看本单位的唯一标识；

（3）院级系统需将平台负责人的通讯邮箱地址上报校级平台；校级平台对数据的验证错误信息会以邮件的方式发送院级系统负责人的邮箱；

（4）院级系统接与校级平台的对接过程中，如果多次出现错误的状态码，需联系相关人员。

用户信息接口

校级平台提供用户信息接口，用于院级系统与校级平台的用户统一认证和管理。具体详情见Oauth说明文档。

对接用户认证开发指南

一、 授权访问流程

（1） 管理单位网站重定向用户到校级平台提供的authorize接口，如果用户同意授权，校级平台会把用户重定向回到院级单位网站，并附上授权码authorize_code；

（2） 校级单位网站使用authorize_code向校级平台的access_token接口发起请求，校级平台在验证请求合法后，会返回访问令牌access_token；

（3） 校级单位网站使用access_token向resource接口发起请求，获取用户信息。

二、 单位平台工作流程

1. 用户在校级平台发起“预约仪器”请求，校级平台将请求重定向到院级平台。

2. 院级平台检查用户登录状态，若是登录状态，则直接转到仪器预约页面；若处于未登录状态，则转到步骤3代表的登录页面。

3. 单位平台的登录页面中要有“使用校级平台账号登录”入口。

4. 若用户选择直接使用院级平台账号登录，则登陆后转到仪器预约页面；若用户选择“使用校级平台账号登录”，则开始授权认证过程。

5. 重定向用户到校级平台authorize接口，请求authorize_code。校级平台authorize接口访问标准如下：

1) URL

2)

3) 返回数据

4) 示例：

请求：

6. ,访问校级平台的access_token接口，请求access_token。校级平台access_token接口访问标准如下：

5) URL

6)

7) 返回数据

8) 示例

请求：

"access_token": "ACCESS_TOKEN",

"expires_in": 1234,

}

7. 获得校级平台返回的access_token,访问校级平台resource接口，请求用户信息。校级平台的resource接口访问标准如下：

9) URL

10)

11)

"username ": "USERNAME",

"email": "EMAIL",

}

8. 院级系统获得用户信息。

9. 院级系统本地应有一个数据库表（新建数据库表或者修改原有数据表，后文用”关联表“代替），用来维持着院级系统账号与校级平台账号的关联关系，保证在获得用户信息后，通过查询关联表，可以获知该用户是否已经进行过关联操作，若查询结果为该用户已经进行过关联，则登录对应的院级系统账号，并转到仪器预约页面；若该用户未进行过关联，进入步骤10。

10. 询问用户是否将校级平台账号关联到已有院级系统账号，若用户选择是则将用户已有院级系统账号与校级平台账号加入关联表；若用户选择否则转到注册页面，该页面利用已经获得的用户信息自动填充相关注册项目，注册用户院级系统账号（注册流程同院级系统正常注册流程），并将账号关联信息加入关联表。

本文来源：https://www.2haoxitong.net/k/doc/a5b11469f38583d049649b6648d7c1c708a10bae.html