DB4401/T 223-2023 教育电子学习资源数据接口规范

ICS35.240.01

CCSL67DB4401

广州市地方标准

DB4401/T223—2023

教育电子学习资源数据接口规范

Specificationofdatainterfaceforeducationale-learningresources

2023-08-05发布2023-09-05实施

广州市市场监督管理局发布

DB4401/T223—2023

目  次

前言……………………………III

引言……………………………V

1范围………………………1

2规范性引用文件…………………………1

3术语和定义………………1

4接口数据模型及数据分类代码…………1

4.1接口数据模型………………………1

4.2数据分类代码………………………5

5数据接口要求……………13

5.1接口访问流程………………………13

5.2接口协议……………13

5.3公共参数……………13

5.4接口调用过程………………………17

5.5对象模型……………17

5.6接口API……………19

附录A（资料性）sha1加密代码实现(Java)…………22

附录B（资料性）数据接口示例………………………23

参考文献……………………27

I

DB4401/TXXXXX—2023

II

DB4401/T223—2023

前  言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由广州市教育局提出并归口。

本文件起草单位：广州市电化教育馆、广州市标准化研究院、广州市越秀区市场监督管理局。

本文件主要起草人：钟毅、孙立杰、彭斌、霍迎辉、郑勇、罗杰明、肖劲峰。

III

DB4401/TXXXXX—2023

IV

DB4401/T223—2023

引  言

教育电子资源作为教育信息化业务中独特元素，承载着各种教学业务信息数据。目前现行国家、行

业或地方标准无针对所有教育资源元数据，尤其是职业教育与幼儿教育、校本资源、校外课程等内容制

定的标准。由于信息化技术发展迅速，各种类型的教育电子资源数据内容不断增加，出现获取资源渠道

多难查询的问题，为此需出台相关标准，为全市教育电子资源管理提供参考依据。

通过制定教育电子资源数据接口标准，可以统筹教师、学生、学校、校外企业等各种教育资源，形

成统一规范，促进资源的共享与流转，提高资源利用率，消除由于部分教育资源内容不统一而导致的混

乱无序等问题隐患。同时，统一教育电子资源数据接口标准，形成区域共建共享的资源体系基础，可促

使市级平台向上与国家级、省级平台，向下与各区区级平台互联互通。

本文件通过教育电子资源描述的定义与教育电子资源数据交互标准，把各级各类教育单位的资源通

过数据接口方式整合，实现新增与已有的异构资源互访。广州教育电子资源的各个供应商、学校、机构

通过数据交互，实现广州市内教育资源数据的共建共享。

V

DB4401/T223—2023

教育电子学习资源数据接口规范

1范围

本文件规定了教育电子学习资源数据接口的数据模型、数据分类代码和数据接口要求。

本文件适用于为广州市行政区域内学前教育、普通中小学和中等职业学校构建的教育电子资源数据

的交互与共享。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件,

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文

件。

GB/T4880.1—2005语种名称代码第1部分：2字母代码

GB/T7408—2005数据元和交换格式信息交换日期和时间表示法

GB/T28825—2012信息技术学习、教育和培训学习对象分类代码

JY/T0607—2017基础教育教学资源元数据信息模型

中国图书馆图书分类法（第五版）

3术语和定义

下列术语和定义适用于本文件。

3.1

教育电子学习资源educationale-learningresources

在教学过程中使用的多种格式的电子文件。

3.2

DB4401

数据接口datainterface

数据平台内或平台之间不同组成部分衔接通讯的约定。

4接口数据模型及数据分类代码

4.1接口数据模型

接口数据模型依据JY/T0607—2017建立，如表1所示。

1

DB4401/T223—2023

表1接口数据模型

序号数据名称数据类型数据长度（字符）备注示例

该资源的描述的名字

1标题，title多语言字符串1000

记录

该资源知识内容所使

用的人类语言主要种

类，语种分类代码从“zh”

语种，

2字符串20《中国图书馆图书分“en”

language_code

类法（第五版）》和“fr-CA”

GB/T4880.1—2005

中选取

其他标题，正式标题之外的其他“zh”“《次北

3多语言字符串1000

alternativetitle名称或替代写法固山下》赏析”

“通过基础知识

运用、整体理解、

课内语段阅读、

以文本方式对资源内课外拓展演练、

4描述，description多语言字符串2000

容的简介读后研习等环

节，全面掌握理

解课文的重点知

识。”

用以描述资源主要内

5关键字，keyword多语言字符串1000“气密性”

容的关键词语

该资源所属学科课文“Demo”“公开

6版本，version多语言字符串50

版本测试版”

该资源所适用的学习

学习方式，learning行为，体现学生在自

7多语言字符串100

mode主性、探究性和合作

性方面的基本特征

该资源的主要使用

8用户类型，audience字符串200者，最重要的优先列“学龄前儿童”

出

课程标准，描述该资源与国家课

9curricular字符串1000程标准内容框架的对

standard应关系

教材目录，textbook描述该资源与教材内

10字符串1000

code容框架对应关系

专题教育资源代码，在实施教育教学的过

11special字符串100程中，专门研究或讨

subject_code论的题目

2

DB4401/T223—2023

表1接口数据模型（续）

序号数据名称数据类型数据长度（字符）备注示例

来源，该资源引用的访问互“http://www.m

12字符串1000

source联网地址/”

作者，发布该资源的作者姓

13多语言字符串100

author名记录

主讲人，该资源中的主讲人的

14多语言字符串100

instructor姓名记录

作者所在单位，该资源创建者的所在

15多语言字符串100

authorc单位名字记录

该资源创建者的所在

单位名字代码，使用

作者所在单位代码，广州市中小学的学校

16字符串100

authorc_code代码（广州市中小学

学籍数据库中各个单

位唯一代码）

作者所在区域或县代

该资源作者所在区域

17码，多语言字符串100

或县代码

author_Area_code

作者所在省份代码，该资源作者所在省份

18多语言字符串100

authorp_code代码

作者所在城市代码，该资源作者所在城市

19多语言字符串100

authorcity_code代码

该资源所属知识点标

课程内容分类代码，

20多语言字符串300识代码，根据JY/T

knowledge_code

0607—2017选取

视频节点，

21字符串100视频资源节点时间戳

vediopointDB4401

语音节点，

22字符串100语音资源节点时间戳

voicepoint

学段代码，

23字符串100该资源所属学段

interval_code

年级代码，

24字符串100该资源所属年级代码

grade_level_code

学科代码，

25字符串100该资源所属学科代码

curricular_code

3

DB4401/T223—2023

表1接口数据模型（续）

序号数据名称数据类型数据长度（字符）备注示例

版本，该资源所属学科课文

26多语言字符串100

version版本

册数，该资源所属学科课文

27多语言字符串100

volume册

单元，该资源所属学科课文

28多语言字符串300

unit单元名称

章，该资源所属学科课文

29多语言字符串300

chapter章名称

节，该资源所属学科课章

30多语言字符串300

part节名称

创建时间，按GB/T7408—

31日期时间该资源创建时间“2020-06-16”

createdtime2005相关要求

下载总数，

32字符串100该资源被下载总量

downloadsum

点击总数，

33字符串100该资源被点击总量

clicksum

收藏总数，

34字符串100该资源被收藏总量

collectsum

资源类型，code

该资源所属资源的类

35learning_resour字符串100

型代码

ce_type_code

该资源在技术上的数

据类型，用于确定资

资源格式，源所需的运行软件。

36字符串100

codeformat_code格式分类代码引用

GB/T28825—2012

中媒体格式分类代码

资源所需计算机存储

资源大小，

37字符串30容量，该数据表明资“2500”

size

源的实际大小

出版社，该资源对应课程的出

38多语言字符串100

publisher版社

其他作者，

39多语言字符串300该资源的其他作者

authoretc

摘要，

40多语言字符串2000该资源的简要描述

abstract

二维码描述，该资源所在访问链接

41字符串300

2D二维码描述

4

DB4401/T223—2023

表1接口数据模型（续）

序号数据名称数据类型数据长度（字符）备注示例

存储地址，多语言字符该资源存储的计算

42300“/1.ppt”

address串机网络访问地址

资源分类代码，

该资源属于的分类

43Resource字符串100

描述

classificationcode

关联类型代码，描述该资源与关联

44字符串8

relationship_code资源之间的关系

关联描述，

45relationship字符串300关联资源的描述

_description

4.2数据分类代码

4.2.1语种分类代码

语种分类代码从《中国图书馆图书分类法（第五版）》和GB/T4880.1—2005选取，如表2所示。

表2语种分类代码

代码语言名称语种代码

H1汉语zh

H212蒙古语mn

H214藏语bo

H215维吾尔语ug

H216苗语——

H217彝语——

H218壮语DB4401za

H219朝鲜语ko

H236哈萨克语（撒里维吾尔语）kk

H31英语en

H32法语fr

H33德语de

H34西班牙语es

H35俄语ru

H36日语ja

H37阿拉伯语ar

H9其他qt

4.2.2学习方式分类代码

5

DB4401/T223—2023

学习方式分类代码如表3所示。

表3学习方式分类代码

代码类型备注

L01讲授

L02探究

L03自学

L04合作

L09其他

4.2.3用户类型分类代码

用户类型分类代码如表4所示。

表4用户类型分类代码

代码类型备注

A01学生

A02教师

A03教育管理员

A04家长

A05未入学青少年

A09其他用户

4.2.4专题教育分类代码

专题教育资源分类代码按照《中国图书馆图书分类法（第五版）》类目简表和JY/T0607—2017，

结合基础教育资源实际编制而成，如表5所示。

表5专题教育分类代