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接口流程
（1）在线服务平台发布预约仪器服务；
（2）用户点击预约按钮，接口将用户的预约请求（仪器所属单位内部编码innerID及单位唯一标识）送至相应的在线服务平台；
（3）在线服务平台接收到国家网络管理平台推送的预约请求，通过在线平台的预约审核流程对预约请求进行审核，根据审核结果并返回具体的仪器预约页面；
（4）用户可以在在线服务平台返回的预约页面中进行仪器预约操作。
2.1.5注意事项
（1）国家管理平台统一分配管理单位的唯一标识；
（2）国家网络管理平台不提供仪器预约服务，只能将用户预约请求推送至在线服务平台，由在线服务平台提供具体的仪器预约服务；
（3）在线服务平台返回给国家网络管理平台的是具体的仪器与预约页面url，而不是在线服务平台的首页或其他页面，并且确保预约页面能打开；
（4）在线服务平台返回的预约页面中必须包括该仪器的开放日历及机时安排情况；
2.2订单查询接口
2.2.1接口描述：国家网络管理平台通过该接口将用户的查询请求推至在线服务平台，获取用户在相应的在线服务平台预约成功的所有订单数据。
2.2.2请求消息参数描述
|
参数名称 |
类型 |
是否为空 |
描述 |
|
userName |
String |
否 |
国家管理平台用户名，用户的唯一标识； |
2.2.3响应消息参数描述
|
参数名称 |
类型 |
是否为空 |
描述 |
|
用户的订单数据
|
List<String> |
否 |
国家管理平台的用户在在线服务平台进行仪器预约形成的订单数据的集合； 实例请参考见附录1中的订单查询示例 |
2.2.4接口流程
（1）在线服务平台发布订单查询服务；
（2）用户想要查询在管理单位的在线服务平台的预约成功的订单情况，调用该接口将用户的查询请求（国家管理平台用户名）送至相应的在线服务平台；
（3）在线服务平台接收到国家网络管理平台推送的查询请求，通过在线平台的审核流程对查询请求进行审核，根据审核结果并返回订单数据；
（4）用户可以在在线服务平台返回的订单数据中进行订单的详情查看操作。
2.2.5注意事项
（1）国家管理平台用户名，是用户的唯一标识；
（2）国家网络管理平台不提供仪器订单服务，只能将用户订单查询请求推送至在线服务平台，由在线服务平台提供相关的订单数据；
（3）在线服务平台返回给国家网络管理平台的是该用户的仪器预约的订单数据，而不是在线服务平台的其他用户的订单信息，并且确保订单数据真实有效；
（4）订单的数据查询为实时查询，在线服务平台应保证用户的实时查询效率。订单的数据状态，具体根据各在线服务平台订单状态数据为准。
2.3订单详情接口
2.3.1接口描述：国家网络管理平台通过该接口将查看订单详情请求推至在线服务平台，获取相应在线服务平台返回预约仪器的订单详情页面。
2.3.2请求消息参数描述
|
参数名称 |
类型 |
是否为空 |
描述 |
|
orderId |
String |
否 |
订单号，用户预约仪器的订单唯一标识； |
|
userName |
String |
否 |
国家管理平台用户名，用户的唯一标识符； |
|
innerId |
String |
否 |
仪器所属单位内部的唯一编码； |
|
insCode |
String |
否 |
管理单位的唯一标识； |
2.3.3响应消息参数描述
|
参数名称 |
类型 |
是否为空 |
描述 |
|
页面的地址（url） |
String |
否 |
仪器订单的详情页面url |
2.3.4接口流程
（1）在线服务平台发布订单详情页面查看服务；
（2）用户订单查询中的查看详情按钮，接口将用户的订单详情请求（订单编号、用户名、仪器所属单位内部编码innerId及单位唯一标识）送至相应的在线服务平台；
（3）在线服务平台接收到国家网络管理平台推送的详情查看请求，通过在线平台的审核流程对请求进行审核，根据审核结果并返回具体仪器预约成功的订单详情页面。
2.3.5注意事项
（1）国家管理平台用户名，是用户的唯一标识；
（2）单位标识，国家管理平台统一分配管理单位的唯一标识；
（3）国家网络管理平台不提供订单详情展示的服务，只能将用户详情请求推送至在线服务平台，由在线服务平台提供具体的订单详情服务；
（4）在线服务平台返回给国家网络管理平台的是具体的仪器订单详情页面url，而不是在线服务平台的首页或其他页面，并且确保订单详情页面能打开；页面中必须包括该仪器的订单各项情况；
（5）在线服务平台对于推送的查询参数冗余，可根据实际情况，处理主要参数项即可，确保返回预约仪器后的订单详情页面，以便用户及时了解仪器预约使用进程。
国家网络管理平台开发的接口：
2.4仪器数据报送接口
2.4.1接口地址：http://218.249.73.248:8080/WS_Server/cxf/instru
接口描述：管理单位在线服务平台上报科学仪器中心、大型科学装置、科学仪器服务单元、单台套科学仪器设备及海关监管信息和服务记录数据的接口。
2.4.2请求消息参数描述
|
参数名称 |
类型 |
是否为空 |
描述 |
|
insCode |
String |
否 |
管理单位的唯一标识； |
|
instruType |
int |
否 |
填报数据类型： 1代表科学仪器中心 2代表大型科学装置 3代表科学仪器服务单元 4代表单台套科学仪器设备 5代表海关监管信息 6代表服务记录 |
|
仪器数据集合 |
List<String> |
否 |
见附录1中的仪器数据报送接口的各类型仪器示例 |
2.4.3响应消息参数描述
|
参数名称 |
类型 |
是否为空 |
描述 |
|
状态码 |
int |
否 |
仪器数据推送结果： 100代表成功 101代表数据存取成功，并返回一些警示信息 200代表单位编码错误 201代表填报数据类型错误 202代表推送的数据json字符串格式错误 203代表验证数据格式错误 204代表其他异常 301代表数据库操作异常 |
2.4.4接口流程
（1）国家网络管理平台发布仪器数据报送服务；
（2）在线服务平台通过该接口推送四大类仪器数据、海关监管信息和服务记录至国家网络管理平台；
（3）国家网络管理平台验证单位唯一标识和仪器类别的正确性，验证通过获取仪器数据及海关监管消息和共享记录；验证失败则返回相应状态码；
（4）国家网络管理平台对上报的仪器数据及海关监管数据和服务数据进行验证，验证通过进行数据库存储，已报过的数据则进行更新；验证失败返回相应状态码；
2.4.5注意事项
（1）在线服务平台通过接口报送的数据格式按照附录1中仪器数据报送接口的各类型仪器示例。
（2）国家管理平台统一分配管理单位的唯一标识；管理单位可登录国家网络管理平台查看本单位的唯一标识，在线服务平台需保存单位标识关联表；
（3）管理单位在线服务平台需将平台负责人的通讯邮箱上报国家网络管理平台；国家管理平台对数据验证的错误信息会以邮件的方式发送在线服务平台负责人的邮箱；
（4）在线服务平台接与国家网络管理平台的对接过程中，如果多次出现错误状态码，及时联系相关人员。
2.5服务成效接口
2.5.1接口地址：http://218.249.73.248:8080/WS_Server/cxf/effect
接口描述：管理在线服务平台将服务成效的数据上报到国家网络管理平台的接口。
2.5.2请求消息参数描述
|
参数名称 |
类型 |
是否为空 |
描述 |
|
insCode |
String |
否 |
管理单位的唯一标识 |
|
服务成效集合 |
List<String> |
否 |
见附录1服务成效接口的示例 |
2.5.3响应消息参数描述
|
参数名称 |
类型 |
是否为空 |
描述 |
|
状态码 |
int |
否 |
服务成效数据推送结果： 100代表成功 200代表单位编码错误 201代表推送的数据json字符串格式错误 202代表数据验证错误 203代表其他异常 301代表数据库操作异常 |
2.5.4接口流程
（1）国家网络管理平台发布服务成效服务；
（2）在线服务平台调用该接口将单位的服务成效数据推送至国家网络管理平台；
（3）国家网络管理平台首先验证单位唯一标识的正确性，验证通过则获取服务成效数据；验证失败则返回相应的状态码；
（4）国家网络管理平台将上报的服务成效数据进行验证，验证通过则保存到数据库中，验证失败则返回相应的状态码；
2.5.5注意事项
（1）在线服务平台通过该接口报送的服务成效数据按照附录1中的服务成效接口的示例。
（2）国家管理平台统一分配管理单位的唯一标识；在线服务平台需保存单位标识关联表；管理单位可登录国家网络管理平台查看本单位的唯一标识；
（3）在线服务平台需将平台负责人的通讯邮箱地址上报国家管理平台；国家管理平台对数据的验证错误信息会以邮件的方式发送在线服务平台负责人的邮箱；
（4）在线服务平台接与国家网络管理平台的对接过程中，如果多次出现错误的状态码，需联系相关人员。
2.6用户信息接口
国家网络管理平台提供用户信息接口，用于在线服务平台与国家管理平台的用户统一认证和管理。具体详情见Oauth说明文档。
附录1：
预约请求接口，示例：
订单查询接口，示例：
[
{
'orderId':'orderId001', //订单号
'instruName':'高温凝胶色谱仪', //仪器名称
'nickname':'liyong', //用户名
'innerId':'2000000', //仪器的唯一编号
'instruType':'4', //仪器类型：1科学仪器中心、2大型科学装置、3科学仪器服务单元、4单台套科学仪器设备
'insCode':'113', //所属单位标识(唯一单位标识，由国家平台分配）
'function':'用于XX实验项目', //仪器预约的用处
'orderTime':'2016-06-06 10:25:02', //订单时间
'orderStatus':'已完成' //订单状态，根据具体的在线服务平台的订单状态
}
]
订单详情接口，示例：
http://www.orderRequest.com/orderDetail?id=238
仪器数据报送接口，示例：
1、科学仪器中心
[
{
'cname':'北京电子能谱中心', //仪器中心名称
'innerId':'000001', //所在单位仪器内部编号(能唯一标识仪器）
'insCode':'113', //所属单位标识(唯一单位标识，由国家平台分配）
'level':'国家级', //仪器中心级别
'url':'http://www.escience.net.cn', //仪器中心网址
'establish':'2002-07-01', //成立日期
'type':'通用', //科学仪器中心类别
'subject':'化学，物理学', //主要学科领域
'serviceContent':'样品测试、分析检测', //服务内容
'achievement':'XXX项目组利用北京电子能谱中心的纳米扫描俄歇系统对ZTO薄膜成分进行纳米尺寸研究。相关研究成果获得了2011年度国家技术发明一等奖', //服务的典型成果
'requirement':'用户可通过上网、邮件、电话等形式按要求填写实验登记，并预约测试时间', //对外开放共享规定
'fee':'一小时内500元，超出一小时部分按每小时400元收费', //参考收费标准
'serviceUrl':'http://www.ServiceUrl.com/order', //预约服务网址
'contact':'张三', //联系人，长度为20
'phone':'010-64411957', //电话
'email':'zhangsan@qq.com', //电子邮箱
'province':'河北省', //通讯地址，省
'city':'廊坊市', //通讯地址，市
'county':'安次区', //通讯地址，区
'street':'万达广场东门', //通讯地址，街道
'postalcode':'100000', //邮政编码
'shareMode':'不共享', //共享模式
'image':'http://218.249.73.246/g/gw196.jpg', //仪器中心图片
'auditStatus':'-1' //提交状态
}
]
2、大型科学装置
[
{
'cname':'同步辐射光源', //装置名称（中文）
'ename':'Synchrotron Radiation Facility（SSFR）', //英文名称
'innerId':'000001', //所属单位仪器内部编号(能唯一标识仪器）'insCode':'113', //所属单位标识(唯一单位标识，由国家平台分配）
'url':'http://www.escience.net.cn', //装置网站的网址
'worth':50000, //原值，万元
'nation':'中国', //产地国别
'beginDate':'2016-01-01', //启用日期
'type':'专用', //装置类型:通用或专用
'technical':'光源由150MeV电子直线加速器、3.5GeV增强器、3.5GeV电子储存环（周长为432米）以及沿环外侧分布的同步辐射光束线和实验站组成', //主要线站与仪器设备及技术指标
'function':'用于蓄电池电压、电流等性能的检测', //主要功能及用途
'subject':'力学', //主要学科领域
'serviceContent':'矢量网络分析仪,微波频域参数测量,微波时域参数测量,微波信号源,微波功率测量', //服务内容
'achievement':'为国家863项目提供了设备支持', //服务的典型成果
'status':'正常', //运行状态
'requirement':'只对系统内认证的用户开放共享', //对外开放共享规定
'fee':'一小时内500元，超出一小时部分按每小时400元收费', //参考收费标准
'serviceUrl':'http://www.ServiceUrl.com/order', //预约服务网址
'province':'河北省', //仪器安放地址，省
'city':'保定市', //仪器安放地址，市
'county':'北市区', //仪器安放地址，区
'street':'学院路37号', //仪器安放地址，街道
'contact':'张三', //联系人
'phone':'010-82053588', //电话
'email':'zhangsan@qq.com', //电子邮箱
'address':'北京市海淀区北京航空航天大学新主楼201', //通讯地址
'postalcode':'100000', //邮政编码
'shareMode':'不共享', //共享模式
'image':'http://218.249.73.246/g/gw196.jpg', //科学装置图片
'auditStatus':'-1' //提交状态
}
]
3、科学仪器服务单元
[
{
'cname':'飞行器结构动力学实验室', //服务单元名称
'innerId':'2222222', //所在单位仪器内部编号(能唯一标识仪器）
'insCode':'113', //所属单位标识(唯一单位标识，由国家平台分配）
'establish':'2016-01-08', //成立日期
'type':'专用', //服务单元类别:专用、通用
'function':'主要用于硅材料的表面轮廓测试形成三维图像，对微纳结构进行分析测量', //主要功能
'subject':'力学,数学', //主要学科领域
'serviceContent':'矢量网络分析仪,微波频域参数测量,微波时域参数测量,微波信号源,微波功率测量', //服务内容
'achievement':'为国家863项目提供了设备支持', //服务的典型成果（简介）
'status':'正常', //运行状态
'requirement':'只对系统内认证的用户开放共享', //对外开放共享规定
'fee':'一小时内500元，超出一小时部分按每小时400元收费', //参考收费标准
'serviceUrl':'http://www.ServiceUrl.com/order', //预约服务网址
'province':'河北省', //安放地址，省
'city':'保定市', //安放地址，市
'county':'北市区', //安放地址，区
'street':'万达广场东门', //安放地址，街道
'contact':'张三', //联系人
'phone':'022-23508336', //电话
'email':'zhangsan@qq.com', //电子邮箱
'address':'北京市海淀区北京航空航天大学新主楼201', //通讯地址
'postalcode':'100000', //邮政编码
'shareMode':'不共享', //共享模式
'image':'http://218.249.73.246/g/gw196.jpg', //服务单元图片
'auditStatus':'-1' //提交状态
}
]
4、单台套科学仪器设备
[
{
'cname':'激光干涉仪', //仪器设备中文名称
'ename':'Laser', //英文名称
'innerId':'20000000', //仪器所在单位内部编号(能唯一标识仪器）
'insCode':'113', //所属单位标识(唯一单位标识，由国家平台分配）
'instrBelongsType':1, //所属仪器类型
'instrBelongsName':'000001', //所属仪器的内部编码
'instrCategory':'030122', //设备分类编码
'instrSource':'购置', //仪器设备来源，
'instrSupervise':'是', //海关监管情况：否、是
'worth':'67.81', //原值，万元
'nation':'阿富汗', //产地国别
'manufacturer':'Renishaw', //生产制造商
'beginDate':'2015-07-14', //启用日期
'type':'专用', //仪器设备类别：专用、通用
'instrVersion':'ML-10', //规格型号
'technical':'测量用', //主要技术指标
'function':'角摆等运动误差参数测量', //主要功能
'subject':'数学，力学，林学', //主要学科领域
'serviceContent':'矢量网络分析仪,微波频域参数测量,微波时域参数测量,微波信号源,微波功率测量', //服务内容
'achievement':'为国家863项目提供了设备支持', //服务的典型成果
'status':'正常', //运行状态
'requirement':'只对系统内认证的用户开放共享', //对外开放共享规定
'fee':'一小时内500元，超出一小时部分按每小时400元收费', //参考收费标准
'serviceUrl':'http://www.ServiceUrl.com/order', //预约服务地址
'province':'河北省', //安放地址，省
'city':'廊坊市', //安放地址，市
'county':'安次区', //安放地址，区
'street':'学院路37号', //安放地址，街道
'contact':'张三', //联系人
'phone':'010-64524931', //电话
'email':'zhangsan@qq.com', //电子邮箱
'address':'北京市海淀区北京航空航天大学新主楼201', //通讯地址
'postalcode':'100000', //邮政编码
'shareMode':'内部共享', //共享模式，
'image':'http://218.249.73.246/g/gw196.jpg', //仪器设备图片
'auditStatus':'-1' //提交状态
}
]
5、海关监管信息
[
{
'innerId':'20000000', //单位内部编号
'insCode':'113', //所属单位标识
'codeCpd':'20113142937', //征免税证明编号
'numberCpd':'1', //征免税证明序号
'declarationNumber':'0001201413928493', //进口报关单编号
'contractNumber':'2029482', //合同号
'importPort':'XX海关', //进口口岸
'responsibleCustoms':'XX海关', //主管海关
'importDate':'2013-02-01', //进口时间
'share':'是', //申报共享标志：是/否
'feesApproved':'是', //收费标准已评议标志:是/否
'hsCode':'283929182', //HS编码（税号)
'record':'X年X月，设备在符合监管条件的前提下，对其他科研用户开展非营利性服务，对外开放共享', //后续管理记录
'auditStatus':'-1' //提交状态
}
]
6、服务记录
[
{
'innerId':'20000000', //设备编号
'insCode':'113', //所属单位标识
'amounts':'12000', //交易金额（元）
'serviceTime':'3', //实际服务时间,时间段或日期
'serviceContent':'样品深度剖析', //实际服务内容
'serviceWay':'占用共享', //服务方式
'serviceAmount':'12.3', //服务量
'subjectName':'石墨烯的光电器件研究', //课题名称
'subjectIncome':'863计划', //课题经费来源
'subjectArea':'力学，数学,化学', //课题主要学科领域
'subjectContent':'通过高温裂解富含不同掺杂元素的反应物，调制掺杂规模制备高质量的硼氮分区掺杂石墨烯', //课题内容
'applicant':'张三', //申请人名称
'applicantPhone':'010-69460000', //申请人电话
'applicantEmail':'test111@buaa.edu.cn', //电子邮箱
'applicantUnit':'北京航空航天大学', //申请人单位
'comment':'非常满意', //用户评价及意见
'auditStatus':'-1' //提交状态
}
]
服务成效接口，示例：
[
{
'insCode':'123', //单位标识
'submittedRates':'95%', //入网比例
'activatedRates':'99%', //正常运行设备比例
'totalShareRates':'80%', //参与共享比例
'externalShareRates':'70%', //外部共享比例
'innovation':'仪器设备功能的升级改造5次；新技术和新方法的研究3种', //仪器创新开发
'serviceAmounts':'样品测试30000个；对外服务机时15000小时；8次培训，培训586人次', //服务总量
'user':'共服务用户500人次，其中个人100人次、科研所200人次、高等院校200人次, //用户类型及数量
'project':'省部级项目：15项；其他项目工程：1项 ', //支撑项目
'thesis':'223篇', //支撑论文
'book':'8个', //支撑论著
'report':'15个', //科技报告数量
'patent':'12个', //专利数量
'output':'215条', //产出科学数据
'achievements':'100.00', //科技成果及获奖情况
'serviceIncome':'856.23', //服务收入
'socialBenefit':'产生4项社会效益，其中重大工程2项、企业创新1项、服务民生1项、应急事件0项', //社会效益
'remark':'其他成果' //其他成果
}
]
数据报送格式规范：
1.科学仪器中心数据字段
|
字段 |
字段名称 |
字段说明 |
|
cname |
仪器中心名称 |
科学仪器中心全称，不可简写（最多50字） |
|
innerId |
所在单位仪器内部编码 |
仪器所在单位系统内部id，能唯一标识仪器 |
|
insCode |
所属单位标识 |
由国家网络管理平台统一分配，唯一标识一个单位 |
|
level |
仪器中心级别 |
国家级、省部级、地市级或单位级等（单选，以所属最高级别为准） |
|
url |
仪器中心网址 |
提供该仪器中心网站对应的URL（最多100字） |
|
establish |
成立日期 |
仪器中心的成立日期（按YYYY-MM-DD格式填写） |
|
type |
科学仪器中心类别 |
通用或专用 |
|
subject |
主要学科领域 |
按国家标准《学科分类与代码》（GB/T 13745-2009）选择填写仪器中心支持科技活动的主要学科名称，涉及多个学科领域的可多选（最多4个）（一级学科） |
|
serviceContent |
服务内容 |
科学仪器中心提供的各类服务项目描述，如样品测试、分析检测、技术咨询、认证服务等（最多200字） |
|
achievement |
服务的典型成果 |
列举该科学仪器中心面向社会提供服务、支撑重大项目或主要成果的典型案例（1-3个，没有可填写无）、（最多500字） |
|
requirement |
对外开放共享规定 |
用户申请条件、申请方式、申请时间、申请流程、申请材料、服务时间安排等的方面的要求（最多500字） |
|
fee |
参考收费标准 |
对外开放相关收费标准，为用户提供服务时收取的费用，按照单位已有收费标准填写。是对仪器中心现有收费标准的概述，无需精确到每台仪器（最多500字） |
|
serviceUrl |
预约服务网址 |
管理单位在线服务平台提供的用户在线预约获取服务接口的URL，能够实现对本仪器中心仪器的预约申请（最多150字） |
|
contact |
联系人 |
联系人姓名（最多20字） |
|
phone |
电话 |
联系人的电话号码，座机（加区号）或手机，以联系人座机为主，一个电话号码即可 |
|
|
电子邮箱 |
联系人的电子邮箱（最多50字） |
|
province city county street |
通讯地址 |
联系人的办公地址（最多100字），标准格式： 省（自治区、直辖市） 市 区（县） 街道（乡镇） |
|
postalcode |
邮政编码 |
联系人办公地址的邮政编码，6位数字 |
|
shareMode |
共享模式 |
内部共享、外部共享、不共享 |
|
image |
仪器中心图片 |
科学仪器中心图片对应的URL（外网可以访问的图片url），图片要求1M字节以内，jpg格式 |
|
auditStatus |
提交状态 |
提交状态：-1或0 -1未提交，代表后期需要对数据进行重复报，更新完善数据； 0提交，代表报送的数据无误，后期无需更新完善。已经提交的数据，再次推送更新无效，需等待后期审核驳回再进行修改。 如果因为失误提交，请等待国家平台审核驳回后更新。（此字段是为了方便填报人员能够批量修改仪器的提交状态，上报数据时，若无该字段，则默认值为-1，即仪器处于未提交状态；若想提交，需要填报人员登录国家网络管理平台手动提交。） |
2.大型科学装置数据字段
|
字段 |
字段名称 |
字段说明 |
|
cname |
装置名称（中文） |
按铭牌信息填写装置的规范名称（最多50字） |
|
ename |
英文名称 |
进口科学装置的英文名称，依据技术资料或铭牌填写。无英文名称的进口或国产科学装置写无（最多100字） |
|
innerId |
所属单位仪器内部编码 |
仪器所在单位系统内部id，能唯一标识仪器 |
|
insCode |
所属单位标识 |
由国家网络管理平台统一分配，唯一标识一个单位 |
|
url |
装置网站的网址 |
提供科学装置所在网站的URL（最多100字） |
|
worth |
原值 |
科学装置的购置单价或研制成本，按资产登记价格填写。国产科学装置以人民币填报，进口科学装置根据建账时的汇率折合成人民币计算（单位为万元，保留2位小数），优惠价及赠送仪器按市场价或资产登记价格填写 |
|
nation |
产地国别 |
科学装置的实际制造地所在国家或地区，按国家标准《世界各国和地区名称代码》（GB/T 2659-2000）选择填写，自主研发的填写中国；国家简称 |
|
beginDate |
启用日期 |
科学装置投入使用的日期（按YYYY-MM-DD格式填写） |
|
type |
装置类别 |
通用或专用 |
|
technical |
主要线站与仪器设备及技术指标 |
构成科学装置的核心线站、主要仪器设备的名称、型号以及能代表仪器设备主要技术性能的指标或参数 （最多500字） |
|
function |
主要功能 |
对科学装置主要功能的简要介绍（最多300个字） |
|
subject |
主要学科领域 |
按国家标准《学科分类与代码》（GB/T 13745-2009）选择填写科学装置支持科技活动的主要学科名称，涉及多个学科领域的可多选（最多4个）（一级学科） |
|
serviceContent |
服务内容 |
科学装置面向用户提供的各类服务项目的描述（最多200字） |
|
achievement |
服务的典型成果 |
列举该科学装置面向社会提供服务、支撑重大项目或主要成果的典型案例。（1-3个，没有可填写无）（最多500字） |
|
status |
运行状态 |
指科学装置当年通常技术性能状态，按正常、待机、远程服务中、偶有故障、故障频繁、待修、待报废选择填写（单选）。按科学装置当年一般状况下的运行状态填写，并非填报时的特定状态 |
|
requirement |
对外开放共享规定 |
用户申请条件、申请方式、申请时间、申请流程、申请材料、服务时间安排等方面的要求（最多500字） |
|
fee |
参考收费标准 |
对外开放相关收费标准，为用户提供服务时收取的费用，按照单位已有收费标准填写。是对大型科学装置现有收费标准的概述，无需精确到每台仪器（最多500字） |
|
serviceUrl |
预约服务网址 |
管理单位在线服务平台提供的用户在线预约获取服务接口的URL，能够实现对本科学装置的预约申请（最多150字） |
|
province city county street |
安放地址 |
科学装置所在的详细地理位置（最多100字），标准格式： 省（自治区、直辖市）、 市、 区（县）、 街道（乡镇，需包括街道/乡镇门牌号） |
|
contact |
联系人 |
联系人姓名（最多20字） |
|
phone |
电话 |
联系人电话号码，座机（加区号）或手机，以联系人座机为主，一个电话号码即可 |
|
|
电子邮箱 |
联系人的电子邮箱（最多50字） |
|
address |
通讯地址 |
联系人的办公地址，标准格式：省（自治区、直辖市）、市、区（县）、街道（乡镇）（最多100字） |
|
postalcode |
邮政编码 |
联系人办公地址的邮政编码，6位 |
|
shareMode |
共享模式 |
内部共享、外部共享、不共享 |
|
image |
科学装置图片 |
科学装置图片对应的URL（外网可以访问的图片url），图片要求1M字节以内，jpg格式 |
|
auditStatus |
提交状态 |
提交状态：-1或0 -1未提交，代表后期需要对数据进行重复报，更新完善数据； 0提交，代表报送的数据无误，后期无需更新完善。已经提交的数据，再次推送更新无效，需等待后期审核驳回再进行修改。
如果因为失误提交，请等待国家平台审核驳回后更新。 |
3.科学仪器服务单元数据字段
|
字段 |
字段名称 |
字段说明 |
|
canme |
服务单元名称 |
服务单元全称，不可简写（最多50字） |
|
innerId |
所属单位仪器内部编码 |
仪器所在单位系统内部id，能唯一标识仪器 |
|
insCode |
所属单位标识 |
由国家网络管理平台统一分配，唯一标识一个单位 |
|
establish |
成立日期 |
服务单元的成立日期（按YYYY-MM-DD格式填写） |
|
type |
服务单元类别 |
通用或专用 |
|
function |
主要功能 |
对服务单元主要功能的简要介绍（最多300个汉字） |
|
subject |
主要学科领域 |
按国家标准《学科分类与代码》（GB/T 13745-2009）选择服务单元支持科技活动的主要学科名称，涉及多个学科领域的可多选（最多4个）（一级学科） |
|
serviceContent |
服务内容 |
服务单元面向用户提供的各类服务项目的描述（最多200字） |
|
achievement |
服务的典型成果 |
列举该服务单元面向社会提供服务、支撑重大项目或主要成果的典型案例（1-3个，没有可填写无）（最多500字） |
|
status |
运行状态 |
服务单元当年通常技术性能状态，按正常、偶有故障、故障频繁、待修、待报废选择填写（单选）。按服务单元当年一般状况下的运行状态填写，并非填报时的特定状态 |
|
requirement |
对外开放共享规定 |
用户申请条件、申请方式、申请时间、申请流程、申请材料、服务时间安排等方面的要求（最多500字） |
|
fee |
参考收费标准 |
对外开放相关收费标准，为用户提供服务时收取的费用，按照单位已有收费标准填写。是对服务单元现有收费标准的概述，无需精确到每台仪器（最多500字） |
|
serviceUrl |
预约服务网址 |
管理单位在线服务平台提供的用户在线预约获取服务接口的URL，能够实现对本服务单元的预约申请。（最多150字） |
|
province city county street |
安放地址 |
服务单元所在的详细地理位置（最多100字）标准格式： 省（自治区、直辖市）、 市、 区（县）、 街道（乡镇，需包括街道/乡镇门牌号） |
|
contact |
联系人 |
联系人姓名（最多20字） |
|
phone |
电话 |
联系人的电话号码，座机（加区号）或手机，以联系人座机为主，一个电话号码即可 |
|
|
电子邮箱 |
联系人的电子邮箱（最多50字） |
|
address |
通讯地址 |
联系人的办公地址，标准格式：省（自治区、直辖市）、市、区（县）、街道（乡镇）（最多100字） |
|
postalcode |
邮政编码 |
联系人办公地址的邮政编码，6位 |
|
shareMode |
共享模式 |
内部共享、外部共享、不共享 |
|
image |
服务单元图片 |
服务单元图片对应的URL（外网可以访问的图片url），图片要求1M字节以内，jpg格式 |
|
auditStatus |
提交状态 |
提交状态：-1或0 -1未提交，代表后期需要对数据进行重复报，更新完善数据； 0提交，代表报送的数据无误，后期无需更新完善。已经提交的数据，再次推送更新无效，需等待后期审核驳回再进行修改。 如果因为失误提交，请等待国家平台审核驳回后更新。 （此字段是为了方便填报人员能够批量修改仪器的提交状态，上报数据时，若无该字段，则默认值为-1，即仪器处于未提交状态；若想提交，需要填报人员登录国家网络管理平台手动提交。） |
4.单台套科学仪器设备数据字段
|
字段 |
字段名称 |
字段说明 |
|
cname |
仪器设备名称 |
按铭牌信息填写仪器设备的规范名称（最多100字） |
|
ename |
英文名称 |
进口仪器设备的英文名称，依据技术资料或铭牌填写。无英文名称的进口或国产仪器设备填无（最多100字） |
|
innerId |
仪器所在单位内部编码 |
能唯一标识一个仪器 |
|
insCode |
所属单位标识 |
由国家网络管理平台统一分配，唯一标识一个单位 |
|
instrBelongsType |
所属大型科学装置/仪器中心/服务单元 |
仪器设备所隶属的科学仪器中心（1）、大型科学装置（2）或服务单元（3）（无隶属关系可填写“无”） |
|
InstrBelongsName |
隶属仪器所在单位仪器内部编号 |
确定隶属大型科学装置/仪器中心/服务单元唯一的一台仪器。（无隶属关系可填写“无”） |
|
instrCategory |
设备分类编码 |
依据“大型科学仪器设备资源的建设与整合”平台建设项目的《大型科学仪器设备分类标准与编码规则（试用）》，按大类、中类、小类选择填写（6位数字代码） |
|
instrSource |
仪器设备来源 |
购置、研制、赠送、其他 |
|
instrSupervise |
海关监管情况 |
仪器是否被海关监管，若仪器被海关监管，填写“是”，若仪器不被海关监管，填写“否” |
|
worth |
原值 |
仪器设备的购置单价或研制成本，按资产登记价格填写。国产仪器设备以人民币填报，进口仪器设备根据建账时的汇率折合成人民币计算（单位为万元，保留2位小数）优惠价及赠送仪器按市场价或资产登记价格填写 |
|
nation |
产地国别 |
仪器设备的实际制造地所在国家或地区，按国家标准《世界各国和地区名称代码》（GB/T 2659-2000）选择填写，自主研发的填写中国；国家简称 |
|
manufacturer |
生产制造商 |
仪器设备生产或设计制造单位的全称（非代理商），自主研发需填写本单位（最多100字） |
|
beginDate |
启用日期 |
仪器投入使用的日期（按YYYY-MM-DD格式填写） |
|
type |
仪器设备类别 |
通用或专用 |
|
instrVersion |
规格型号 |
按仪器设备生产制造厂商的标识填写（最多100字） |
|
technical |
主要技术指标 |
指验收时达到的、能代表仪器设备主要技术性能的指标或参数（最多500字） |
|
function |
主要功能 |
对仪器设备主要功能的简要介绍（300字以内） |
|
subject |
主要学科领域 |
按国家标准《学科分类与代码》（GB/T 13745-2009），选择单台套科学仪器设备支持科技活动的主要学科名称，涉及多个学科领域的可多选（最多4个）（一级学科） |
|
serviceContent |
服务内容 |
单台套科学仪器设备面向用户提供的各类服务项目的描述，如样品测试、分析检测、技术咨询、认证服务等（最多200字） |
|
achievement |
服务的典型成果 |
列举该仪器设备面向社会提供服务、支撑重大项目或主要成果的典型案例（1-3个，没有可填写无）（最多500字） |
|
status |
运行状态 |
仪器设备当年通常技术性能状态，按正常、偶有故障、故障频繁、待修、待报废选择填写（单选）。按仪器设备当年一般状况下的运行状态填写，并非填报时的特定状态 |
|
requirement |
对外开放共享规定 |
用户申请条件、申请方式、申请时间、申请流程、申请材料、服务时间安排等方面的要求（最多500字） |
|
fee |
参考收费标准 |
对外开放相关收费标准，为用户提供服务时收取的费用，按照单位已有收费标准填写（最多500字） |
|
serviceUrl |
预约服务网址 |
管理单位在线服务平台提供的用户在线预约获取服务接口的URL，能够实现对本仪器的预约申请（最多150字） |
|
province city county street |
安放地址 |
仪器所在的详细地理位置（最多100字），标准格式： 省（自治区、直辖市）、 市、 区（县）、 街道（乡镇，需包括街道/乡镇门牌号） |
|
contact |
联系人 |
联系人姓名（最多20字） |
|
phone |
电话 |
联系人的电话号码，座机（加区号）或手机。以联系人座机为主，一个电话号码即可 |
|
|
电子邮箱 |
联系人的电子邮箱（最多50字） |
|
address |
通讯地址 |
联系人的办公地址，标准格式：省（自治区、直辖市）、市、区（县）、街道（乡镇）（最多100字） |
|
postalcode |
邮政编码 |
联系人办公地址的邮政编码,6位 |
|
shareMode |
共享模式 |
内部共享、外部共享、不共享 |
|
image |
仪器图片 |
仪器设备图片对应的URL（外网可以访问的图片url），图片要求1M字节以内，jpg格式 |
|
auditStatus |
提交状态 |
提交状态：-1或0 -1未提交，代表后期需要对数据进行重复报，更新完善数据； 0提交，代表报送的数据无误，后期无需更新完善。已经提交的数据，再次推送更新无效，需等待后期审核驳回再进行修改。 如果因为失误提交，请等待国家平台审核驳回后更新。 （此字段是为了方便填报人员能够批量修改仪器的提交状态，上报数据时，若无该字段，则默认值为-1，即仪器处于未提交状态；若想提交，需要填报人员登录国家网络管理平台手动提交。） |
5.海关监管消息
|
字段 |
字段名称 |
字段说明 |
|
innerId |
所在单位仪器编号 |
管理单位资产管理部门赋予该仪器设备唯一编号 |
|
insCode |
所属单位标识 |
由国家网络管理平台统一分配，唯一标识一个单位 |
|
codeCpd |
征免税证明编号 |
长度12位：固定位（5位）+年份（2位）+随机（5位），按《中华人民共和国进出口货物征免税证明表》（以下简称征免税证明表）中的编号填写 |
|
numberCpd |
征免税证明序号 |
若多个货物同时申报免税，根据在征免税证明表中货物序号排列，填写对应的序号 |
|
declarationNumber |
进口报关单编号 |
长度18位：海关编号（4位）+年份（4位）+进口标志（1位）+随机（9位），按征免税证明表填写 |
|
contractNumber |
合同号 |
按征免税证明表填写（最多50字） |
|
importPort |
进口口岸 |
按征免税证明表填写（最多50字） |
|
responsibleCustoms |
主管海关 |
按征免税证明表填写（最多50字） |
|
importDate |
进口日期 |
按征免税证明表填写 |
|
share |
申报共享标志 |
已申报共享，填写“是”，未申报共享，填写“否” |
|
feesApproved |
收费标准已评议标志 |
收费标准已评议，填写“是”，未评议，填写“否” |
|
hsCode |
HS编码（税号） |
按征免税证明表填写（最多50字） |
|
record |
后续管理记录 |
仪器的后续管理记录信息（最多200个字） |
|
auditStatus |
提交状态 |
提交状态：-1或0 -1未提交，代表后期需要对数据进行重复报，更新完善数据； 0提交，代表报送的数据无误，后期无需更新完善。已经提交的数据，再次推送更新无效，需等待后期审核驳回再进行修改。 如果因为失误提交，请等待国家平台审核驳回后更新。 （此字段是为了方便填报人员能够批量修改仪器的提交状态，上报数据时，若无该字段，则默认值为-1，即仪器处于未提交状态；若想提交，需要填报人员登录国家网络管理平台手动提交。） |
6.服务记录
|
字段 |
字段名称 |
字段说明 |
|
innerId |
所在单位仪器内部编号 |
管理单位资产管理部门赋予该仪器设备唯一编号 |
|
insCode |
所属单位标识 |
由国家网络管理平台统一分配，唯一标识一个单位 |
|
amounts |
服务金额 |
实际服务的总额，以元为单位 |
|
serviceTime |
实际服务时间 |
科研设施与仪器向用户实际提供服务的日期或时间段 |
|
serviceContent |
实际服务内容 |
科研设施与仪器向用户实际提供的服务项目，如样品测试、分析检测等，最多200字 |
|
serviceWay |
服务方式 |
一是占用共享，即服务客体(需求者)按一定规程自行操作使用；二是技术共享，即在服务主体的技术指导下，服务客体有限度地自主使用操作仪器设备；三是委托共享，即受服务客体委托，由服务主体按要求启动和运行仪器设备，并向委托方提交相应结果；四是远程共享；五是其他（可多选） |
|
serviceAmount |
服务量 |
根据订单，科研设施与仪器所提供的服务量，根据仪器类型和服务方式的不同，可按所占用的时长或次数（包含必要开机准备时间、测试时间和必须的后处理时间，不包括空载运行的时间，计量单位为小时）、样品测试数量、分析检测数量、技术指导次数等该领域统计方法计算。 |
|
subjectName |
课题名称 |
用户利用科研设施与仪器所支撑的课题名称（没有则填写“无”） |
|
subjectIncome |
课题经费来源 |
课题最主要的经费来源，可多选（最多4个）： A 国家重大科技专项；B 国家自然科学基金；C 863计划；D 国家科技支撑（攻关）计划；E 火炬计划；F 星火计划；G 973计划；H 211工程；I 985工程；J 公益性行业科研专项；K 国家社会科学基金；L 国家科技基础性工作专项；M 科技基础条件平台专项；N 除上述国家计划外由中央政府部门下达的课题；O 地方科技计划项目；P 其他 |
|
subjectArea |
课题主要学科领域 |
用户申请机时进行研究的课题所属的主要学科领域，按国家标准《学科分类与代码》（GB/T 13745-2009）选择填写主要学科名称，涉及多个学科领域的可多选（最多4个，一级学科） |
|
subjectContent |
课题研究内容 |
用户利用科研设施与仪器所研究的课题的基本内容概述（最多200字）（没有则填写“无”） |
|
applicant |
申请人 |
申请人的姓名（最多20字） |
|
applicatPhone |
申请人电话 |
申请人的电话号码，座机（加区号）或手机（最多20字）以座机为主 |
|
applicatEmail |
申请人电子邮箱 |
申请人的电子邮箱（最多50字） |
|
applicatUnit |
申请人单位 |
申请人所在单位（最多50字） |
|
comment |
用户评价及意见 |
用户对本次服务的评价，非常满意、基本满意、一般、不满意、极差（单选）。具体的意见和建议 |
|
auditStatus |
提交状态 |
提交状态：-1或0 -1未提交，代表后期需要对数据进行重复报，更新完善数据； 0提交，代表报送的数据无误，后期无需更新完善。已经提交的数据，再次推送更新无效，需等待后期审核驳回再进行修改。 如果因为失误提交，请等待国家平台审核驳回后更新。 （此字段是为了方便填报人员能够批量修改仪器的提交状态，上报数据时，若无该字段，则默认值为-1，即仪器处于未提交状态；若想提交，需要填报人员登录国家网络管理平台手动提交。） |
7.服务成效数据字段
|
字段 |
字段名称 |
字段说明 |
|
insCode |
单位标识 |
由国家网络管理平台统一分配，唯一标识一个单位 |
|
submittedRates |
科研设施与仪器入网比例 |
指该管理单位在国家网络管理平台注册填报的科研设施与仪器占符合申报条件的全部科研设施与仪器的比例，体现了纳入国家网络管理平台的情况 |
|
activatedRates |
正常运行设备比例 |
纳入国家网络管理平台的科研设施与仪器正常运行的数量占纳入的全部科研设施与仪器数量的比例 |
|
totalShareRates |
参与共享比例 |
指参与共享（包括内部共享和外部共享两种方式）的科研设施与仪器和全部符合共享条件科研设施与仪器的数量之比，体现了总体开放共享服务的情况 |
|
externalShareRates |
外部共享比例 |
指提供对外服务的科研设施与仪器占全部符合共享条件的科研设施与仪器的比例，体现了对外开放共享服务的比例情况 |
|
innovation |
仪器创新开发 |
管理单位仪器功能开发、新技术和新方法的研究、仪器设备功能的升级改造、仪器研究能力、科研设施与仪器自主创新研发能力的情况及数量（最多500字） |
|
serviceAmounts |
服务总量 |
科研设施与仪器对外提供服务的总量，根据仪器类型和服务方式的不同，包括设备机时服务、样品测试数量、分析检测服务、培训等（最多200字） |
|
user |
用户类型及数量 |
科研设施与仪器服务用户的类型及数量（单位：人/次） |
|
project |
支撑项目 |
科研设施与仪器对外服务，用户完成的各种科研项目或合作项目数的数量，特别是服务各级各类科技计划（专项、基金、重大工程）等情况（最多200字） |
|
thesis |
支撑论文 |
用户利用科研设施与仪器所产生的论文数量，包括已公开发表的论文，或者尚未正式发表但已被录用的论文，特别是在三大检索SCI、EI、ISTP发表的论文，最多200字 |
|
book |
支撑论著 |
用户利用科研设施与仪器所产生的论著或专著数量（最多200字） |
|
report |
支撑科技报告 |
用户利用科研设施与仪器所产生的科技报告数量（最多200字） |
|
patent |
支撑发明专利 |
用户利用科研设施与仪器所产生的发明专利的数量，指已授权发明专利数，不含实用新型和外观设计（最多200字） |
|
output |
产出科学数据 |
用户使用科研设施与仪器过程中产生的原始数据及研究分析数据，包括调查观测、测试化验、实验研究等相关科学数据（最多200字） |
|
achievements |
科技成果及获奖情况 |
使用科研设施与仪器产生的科技成果及获奖成果数量（最多200字） |
|
serviceIncome |
对外服务收入 |
管理单位科研设施与仪器对外服务获得的收入，以人民币计算（单位万元，保留小数点后两位）。包括科研设施与仪器对外提供服务收入的测试费、租赁收入和其他服务收入等 |
|
socialBenefit |
社会效益 |
科研设施与仪器对外开放共享所产生的社会效益，如服务重大工程、企业创新、服务民生、应急事件、科学普及、政府决策、其他等情况（最多500字） |
|
remark |
其他成果 |
非上述成果之外的成果（最多200字） |
对接用户认证开发指南
一、 Oauth2.0授权访问流程
（1） 管理单位网站重定向用户到大仪平台提供的authorize接口，如果用户同意授权，大仪平台会把用户重定向回到管理单位网站，并附上授权码authorize_code；
（2） 管理单位网站使用authorize_code向大仪平台的access_token接口发起请求，大仪平台在验证请求合法后，会返回访问令牌access_token；
（3） 管理单位网站使用access_token向resource接口发起请求，获取用户信息。
二、 单位平台工作流程
按上图中步骤标号依次说明开发过程（注：以下叙述中“国家平台”即为“大仪平台”，“单位平台”即为“各管理部门自建平台”）：
1. 用户在国家平台发起“预约仪器”请求，国家平台将请求重定向到单位平台。
2. 单位平台检查用户登录状态，若是登录状态，则直接转到仪器预约页面；若处于未登录状态，则转到步骤3代表的登录页面。
3. 单位平台的登录页面中要有“使用大仪平台账号登录”入口。
4. 若用户选择直接使用单位平台账号登录，则登陆后转到仪器预约页面；若用户选择“使用大仪平台账号登录”，则开始oauth2.0授权认证过程。
5. 重定向用户到国家平台authorize接口，请求authorize_code。国家平台authorize接口访问标准如下：
1) URL
https://mainplatform/oauth2/authorize
2) HTTP请求方式
GET/POST
3) 请求参数
|
参数 |
必选 |
类型及范围 |
说明 |
|
client_id |
true |
string |
注册应用时分配的ID |
|
response_type |
true |
string |
返回类型，固定为code |
|
redirect_uri |
true |
string |
授权回调地址，需与注册时设置的回调地址一致 |
|
scope |
true |
string |
申请scope权限所需参数，只提供read一种 |
|
state |
true |
string |
用于保持请求和回调的状态，在回调时，会回传该参数。开发者可以用这个参数验证请求有效性，也可以记录用户请求授权页前的位置。这个参数可用于防止跨站请求伪造（CSRF）攻击 |
4) 返回数据
|
返回值字段 |
字段类型 |
字段说明 |
|
code |
string |
用于调用access_token接口，获取授权后的access token |
|
state |
string |
如果传递参数，会回传该参数 |
5) 示例：
请求：
https://mainplatform/oauth2/authorize?client_id=CLIENT_ID&redirect_uri=http://subplatform/response&response_type=code&scope=read&state=STATE
同意授权后会重定向用户到：
http://subplatform/response?state=STATE&code=CODE
6. 单位平台获得authorize_code,访问国家平台的access_token接口，请求access_token。国家平台access_token接口访问标准如下：
1) URL
https://mainplatform/oauth2/access_token
2) HTTP请求方式
POST
3) 请求参数
|
参数 |
必选 |
类型及范围 |
说明 |
|
client_id |
true |
string |
注册应用时分配的ID |
|
client_secret |
true |
string |
注册应用时分配的secret |
|
grant_type |
true |
string |
请求的类型，填写authorization_code |
|
code |
true |
string |
调用authorize获得的code值 |
|
redirect_uri |
true |
string |
回调地址，需与注册应用里的回调地址一致 |
4) 返回数据
|
返回值字段 |
字段类型 |
字段说明 |
|
access_token |
string |
用于调用资源访问接口，获取用户数据 |
|
expires_in |
string |
access_token的生命周期，单位是秒数 |
5) 示例
请求：
https://mainplatform/oauth2/access_token?client_id=CLIENT_ID&client_secret=CLIENT_SECRET&grant_type=authorization_code&code=CODE&redirect_uri=http://subplatform/response
成功获取后返回数据：
{
'access_token': 'ACCESS_TOKEN',
'expires_in': 1234,
}
7. 获得国家平台返回的access_token,访问国家平台resource接口，请求用户信息。国家平台的resource接口访问标准如下：
1) URL
https://mainplatform/oauth2/resource/RESOURCE_NAME
2) HTTP请求方式
GET
3) 请求参数
|
参数 |
必选 |
类型及范围 |
说明 |
|
access_token |
true |
string |
调用access_token获得的access_token值 |
|
RESOURCE_NAME |
ture |
string |
访问资源的名称 |
4) 返回数据
|
返回值字段 |
字段类型 |
字段说明 |
|
json字符串 |
string |
资源键值对 |
5) 示例
请求：
https://mainplatform/oauth2/resource/userinfo?access_token=ACCESS_TOKEN
返回数据：
{
'username ': 'USERNAME',
'email': 'EMAIL',
}
8. 单位平台获得用户信息。
9. 单位平台本地应有一个数据库表（新建数据库表或者修改原有数据表，后文用”关联表“代替），用来维持着单位平台账号与国家平台账号的关联关系，保证在获得用户信息后，通过查询关联表，可以获知该用户是否已经进行过关联操作，若查询结果为该用户已经进行过关联，则登录对应的单位平台账号，并转到仪器预约页面；若该用户未进行过关联，进入步骤10。
10. 询问用户是否将国家平台账号关联到已有单位平台账号，若用户选择是则将用户已有单位平台账号与国家平台账号加入关联表；若用户选择否则转到注册页面，该页面利用已经获得的用户信息自动填充相关注册项目，注册用户单位平台账号（注册流程同单位平台正常注册流程），并将账号关联信息加入关联表。
三、 工作总结
1. 开发工作
|
开发工作 |
前端开发 |
后台开发 |
|
检查登录状态及登录页面修改（包括上图中步骤1,2,3,4） |
登录页面添加“使用大仪平台账号登录”选项，链接指向单位平台重定向接口 |
在需用户登录才可访问的页面处添加登录状态验证，并做相应处理； 开发重定向接口，生成state码，重定向用户到oauth的authorize接口 |
|
oauth2.0过程（包括上图中步骤5,6,7,8） |
无 |
编写一个接口用以接收authorize请求的返回值(code)； 调用token接口获取访问令牌； 调用resource接口获取用户数据 |
|
用户信息管理（包括上图中步骤9,10） |
用户注册及关联账号的页面 |
开发关联国家平台与单位平台用户的功能； 由国家平台用户信息调取单位平台用户信息并登录的功能 |
2. 其他工作
向国家平台提交redirect_uri，此地址用以获取oauth authorize接口返回值。
国家平台审核通过后会给出client_id与client_secret
崇尚科学 以人为本 合作共赢
内蒙古大学奥都科技开发有限责任公司
联系电话：+86 0471-4992411
传 真：+86 0471-4992411
地 址：内蒙古呼和浩特市大学西路235号内蒙古大学留学生公寓B座416室