第三方资源接入要求.docx

第三方资源接入要求

资源数据版权要求

资源提供者需版权证明（软件著作权登记证书、电子出版证明个、著作权许可使用协议、著作权转让协议或授权文件等）

资源数据内容要求

1）资源内容应与教育教学内容相关；

2）资源内容符合国家相关法律法规、教育方针和教育信息化相关文件精神，坚持政治性、科学性、适用性原则，符合教育教学规律，不存在强制性收费、植入广告、涉黄涉赌、暴力、反动等方面的问题，同时确保用户在资源产品的使用期限、增值服务、个性化功能、评价反馈和投诉等方面享有充分知情权。

资源数据编目要求

资源编目需按省平台编目接入。编目接口详见章节

资源提供者要求

第三方资源提供者应是事业法人、企业法人、社会团体、社会组织等法人机构(暂不包括个人)。

第三方资源接入

第三资源接入与第三方应用接入流程类似。第三方资源提供者登录省平台，在应用开发页面的“应用材料申报”按钮，在弹出层中选择“第三方资源”，进第三方应用资源申报。后续流程与第三方应用接入类似。

为实现第三方优质资源方便、快捷的引入，省平台支持资源索引信息接入和资源实体文件接入两种方式。第三方资源接入时需进行相关资源接口的申请，待管理员审核通过后，即可对接开发、调试。

第三方资源索引接入

资源索引信息接入是指将资源的基础信息、编目信息及访问页面地址等信息以接口的方式，推入到省平台中。资源的实体文件存储在提供资源的第三方应用中，用户可在省平台的资源频道中检索，用户浏览资源文件时，直接跳转到第三方的应用内查阅。

省平台提供标准规范接口，第三方资源提供者调用资源入库接口、资源编目接口，按资源的编目规范，将资源推送至省平台。入库信息包括：入库方式、资源标题、简介、关键字、资源编目（学段、学科、版本、册别、教材、章节）、资源类型、资源预览地址、文件大小、资源来源、文件后缀。资源浏览和下载能力由第三方提供者提供。

资源索引信息接入流程图

获取appid秘钥和appkey

第三方资源提供者可通过应用接入的方式，获取接入应用的appId和appKey。用appId和appKey对接开发应用获取访问令牌，再通过访问令牌调用资源接入接口带入资源目录。（参见应用接入）

示例如下：

appId:c1e1957*********

appKey:70fabe*********

获取访问令牌

通过appId和appKey获取资源的接口访问权限。调用方式如下：

接口地址：

http://ip:port/apigateway/getAccessToken

请求方式：post

请求参数：

{"appid":"c1e1957*********","timestamp":1565179079173,"keyinfo":"4cb48f*********"}

字段说明：

appid：应用ID

timestamp：时间戳

keyinfo：加密字符串，

加密算法HmacSHA1，加密明文值为appId+appKey+timestamp拼接后的字符串，加密key为appKey，加密得到的值为keyinfo参数值

返回参数示例：

{

"tokenInfo":{

"platformCode":"******",

"validTime":"1565186622059",

"appName":"******",

"accessToken":"******",

"appstatus":"3",

"appId":"c1e1957*********",

"account":"1"

},

"retCode":"000000",

"retDesc":"获取Token成功"

}

调用资源编目接口

在进行资源编目入库时，需通过调用资源编目接口获取省平台标准的学段Id、学科Id、版本Id、册别Id、章节Id信息。

业务接口必须通过鉴权调用。（参见章节）

接口调用方式如下：

url后带上accessToken参数。

例如：http://ip:port/XXX?accessToken=*********

获取学段列表接口

根据教材数据关联查询学段信息

请求说明

url

/cms-gateway/queryPeriods

支持验证方式

格式

application/json

协议

post

是否需要鉴权

false

请求数限制

false

接口方向

第三方?CMS

参数说明

序号

字段名

是否必填

类型

说明

1

subjectId

N

String

学科ID

2

gradeId

N

String

年级ID

3

volumeId

N

String

册别ID

4

editionId

N