DB4403_T 198-2021课堂教学行为数据交换规范.pdf

ICS 35.240.99CCS A 18DB4403深圳市地方标准DB4403/T 1982021课堂教学行为数据交换规范Data exchange specification for classroom teaching behavior2021-11-16 发布2021-12-01 实施深圳市市场监督管理局发 布DB4403/T 1982021I目次前言 II1范围 12规范性引用文件 13术语和定义 14课堂教学行为框架 25总体要求 36交换要求 47数据要求 6附录 A（规范性）学习行为 xAPI 规范 8附录 B（规范性）数据交换设计 12附录 C（资料性）数据交换接口示例 15附录 D（规范性）基础数据 30附录 E（规范性）课堂教学行为数据格式 34参考文献 44DB4403/T 1982021II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由深圳市教育局提出并归口。本文件起草单位：深圳市教育信息技术中心、北京师范大学、华中师范大学、华南师范大学、科大讯飞股份有限公司、上海一起作业信息科技有限公司、深圳市海云天科技股份有限公司、上海中文在线文化发展有限公司、学科网(北京)股份有限公司、深圳市腾讯计算机系统有限公司、武汉天喻教育科技有限公司、深圳市全景教育科技有限公司、武汉颂大教育技术有限公司、紫光教育科技有限公司。本文件主要起草人：张惠敏、梁为、陈浩、王奕奕、纪显俐、戴俊雄、吴砥、张学波、郑勤华、王龙生、杨熙、欧思泱、王培峰、陈学艺、刘青、余斌、张露茜、姜峰、郑琦。DB4403/T 19820211课堂教学行为数据交换规范1范围本文件规定了课堂教学行为的框架与课堂教学行为数据交换的基本要求、交换要求和数据要求。本文件适用于深圳市中小学市、区、校三级课堂教学行为信息的数据交换，支撑深圳市实现对教学行为数据的记录、追踪和分析以及开展教学过程性评价，指导差异化教学。2规范性引用文件本文件没有规范性引用文件。3术语和定义下列术语和定义适用于本文件。3.1课堂classroom中小学教师进行教学活动的物理空间。3.2教学行为instructional behavior教学活动中的一系列围绕教学内容展开的教与学行为。3.3数据交换data exchange数据采集及交换的技术行为。3.4学习者learner依靠学习技术系统获取知识或技能的个体。3.5教师teacher依靠学习技术系统传递知识或技能的个体。3.6学习行为learning behavior学习活动中的一系列行为。DB4403/T 198202123.7知识点knowledge point知识、理论、道理、思想等的相对独立的最小单元，是课程中信息传递的基本单元。3.8互动类型interact type教师与学习者借助技术手段进行的交互方式。4课堂教学行为框架4.1课堂教学行为框架框架包括课堂教学行为、课堂学习行为、课堂教育资源，见图 1。图 1课堂教学行为框架4.2课堂教学行为课堂教学行为分为：教学准备行为：记录教师课前的相关教学准备行为，包括登录和备课等行为；教学组织行为：记录教师组织教学的行为，包括开课、授课，下发练习、测试和作业等行为；课堂交互行为：记录教师引导、激励学生学习的行为，发起讨论、投票、抢答、随机选人作答、全班作答、资源分享、教学答疑和辅导等行为；评价反馈行为：记录教师对学习者评价的行为，包括查看学生的作业、作品、测试和考试，评价学生的作业等行为。4.3课堂教育资源课堂教育资源分为：教学资源：教师上课使用的教材资源，包括电子书、备课、授课等教学活动中使用的资源；试题资源：考试、练习、测验中使用的题目资源。DB4403/T 198202134.4课堂学习行为课堂学习行为分为（数据应符合附录 A 的规定）：学习轨迹行为：记录学习者的操作行为链（点击流），包括登录、退出、提交等对系统页面操作的行为；资源学习行为：记录学习者学习的资源以及对资源进行的操作，包括浏览、使用、上传、下载学习资源等行为；课堂交互行为：记录学习者与其他学习者、教师、管理员的交流行为，包括发起提问、资源分享等行为；评价反思行为：记录学习者参与测试、评价的行为，包括完成并提交练习、课堂实验、作业和测试，完成互评和错题订正，对自我、同伴、教师进行评价等行为。5总体要求5.1数据项组成元数据结构如下：中文简称：所用的数据元素的名称，具有语义，面向用户；数据项名：通常由中文简称的汉语拼音首字母（大写）组成，与中文简称一一对应，宜在实际数据结构中采用；类型：数据项容纳的数据类型，本文件在数据项中简称其为类型（一种属性）；长度：数据项能容纳的最大字符数（一种属性）；约束：数据项约束状态的描述，即必备数据项或可选数据项（一种属性）；解释/举例：数据项属性的说明或举例。5.2数据类型5.2.1字符型字符型为 C，在信息系统中取用时，可以是可变长度。5.2.2数值型数值型为 N，可参与运算。5.2.3二进制类型二进制类型为 B，宜在照片或超长文本使用。5.2.4文本型文本型为 T，用于数量较多的文字描述。数据值长度大于 1000 字符时应采用文本型。5.3约束数据约束条件有可选数据元素 O 和必备数据元素 M 两种。5.4时间格式定义系统定义的时间格式为年-月-日 时：分：秒（yyyy-MM-dd HH:mm:ss）。DB4403/T 198202145.5数据传输方式结构化数据采取文本形式传输；非结构化数据（如视频类、音频类）采用文件方式进行数据传输，采取二进制形式存储。6交换要求6.1基本要求6.1.1数据交换对象是深圳市、区、校三级课堂教学信息系统的课堂教学行为数据。数据交换类别包括结构化数据、非结构化数据。其中，视频、图片、音频、文档类等附件数据是非结构化数据，文本信息类、数据库表数据是结构化数据。6.1.2数据交换可采用不同的数据交换方式进行（具体交换设计应符合附录 B 的规定），包括但不限于：a)库表交换；b)资源文件交换；c)服务接口交换。6.2库表交换基于数据库表结构形式进行数据交换，适用于大量历史数据的交互或适用数据增量更新频繁的数据交换，结构如图 2 所示。图 2基于数据库的交换方式6.3资源文件交换6.3.1通过文件交换的形式进行数据交换，适用于非结构化资源或更新频率比较缓慢的结构化资源的数据交换。结构如图 3 所示。DB4403/T 19820215图 3基于文件的交换方式6.3.2资源文件交换方式基于前置机进行网络安全隔离，文件上传和下载接口协议使用 HTTPS 协议，通过提供访问的 URL，用户使用 HTTP POST 方法发送请求。6.4服务接口交换6.4.1将数据服务封装成接口，供数据使用方调用，适用于小数据量、实时性要求较高的数据交换，结构如图 4 所示。图 4服务接口交换方式6.4.2服务数据交换采用 RESTful 风格 API，数据格式统一采用 JSON 格式，接口示例见附录 C。接口协议采用Https，接口编码采用 UTF-8。安全验证应根据授权用户和密码产生的随机Token来访问各API。接口数据的返回格式为 JSON 格式字符串，接口返回值数据格式应符合表 1 的要求。表 1数据格式JSON 变量说明Success调用接口操作成功标志，boolean 值 true、falseCode返回结果状态标识，0 代表成功，1 代表失败DB4403/T 19820216表 1数据格式（续）JSON 变量说明Message返回结果的文字说明Data返回的结果数据7数据要求7.1课堂教学行为数据基于框架拆解，主要包括但不限于以下数据：a)用户登录信息，b)教师开课信息，c)教师备课信息，d)教师授课信息，e)课堂互动信息，f)资源使用信息，g)作业布置信息，h)作业报告信息，i)作业答题信息，j)课堂测验信息，k)课堂测验报告，l)试题集信息，m)题目信息，n)知识点信息，o)教材课本信息，p)教学资源信息，q)学习行为信息。7.2元数据应符合表 2 所示数据交换索引。表 2数据交换索引表序号数据类别数据信息具体数据要求1基础数据学段信息见 D.12年级信息见 D.23学科信息见 D.34行政区信息见 D.45学习者信息见 D.56操作行为信息见 D.67互动类型信息见 D.7DB4403/T 19820217表 2数据交换索引表（续）序号数据类别数据信息具体数据要求8基础数据资源来源信息见 D.89课堂教学行为数据用户登录信息见 E.110教师开课信息见 E.211教师备课信息见 E.312教师授课信息见 E.413课堂互动信息见 E.514资源使用信息见 E.615作业布置信息见 E.716作业报告信息见 E.817作业答题信息见 E.918课堂测验信息见 E.1019课堂测验报告见 E.1120试题集信息见 E.1221题目信息见 E.1322知识点信息见 E.1423教材课本信息见 E.1524教学资源信息见 E.1625学习行为信息见 C.2DB4403/T 19820218附录A（规范性）学习行为 xAPI 规范A.1xAPI 规范框架A.1.1xAPI规范框架包括操作ID，操作者，动作，对象，结果等，如图A.1。图 A.1xAPI 用户学习行为框架A.1.2用户学习行为元素A.1.2.1操作 ID操作标示符。操作 ID 是一个唯一标识符，在一些不必要的场合可以省略。A.1.2.2Actor操作者。每一个学习行为、每一个学习活动，都应有一个提供者、参与者，代表的是谁在学习、是由谁发起了这个活动。A.1.2.3Verb动作。表示操作者的具体操作行为。具体动词及其语义如表 A.1。表 A.1xAPI 动作定义动作描述Answered回答Vote投票Asked提问Attended参加Commented评论Completed完成Login-out退出Start开始Experienced经历Failed失败Input输入DB4403/T 19820219表 A.1xAPI 动作定义（续）动作描述Initialized初始化Interacted交互Launched发布Passed通过Failed未通过Mastered掌握See观看Preferred偏好Registered注册Login-in登录Meeting会议Responded响应Resumed继续Scored得分Shared分享Suspended暂停Terminated结束A.1.2.4Object对象。对象中包含有两个子属性：操作对象编码和操作对象名称。A.1.2.5Result结果。该属性是可以扩展的，它主要描述一些动作结果，如得分、通过与否和完成进度等。A.1.2.6Context上下文环境。该属性提供一些活动中的上下文信息,包括但不限于厂商名称、应用名称、设备 IP、设备类型、设备型号等。A.1.2.7TimeStamp活动发生时间。A.1.2.8StoredTime记录存储时间。A.1.2.9Authority授权。出于对安全性的考虑，通常存储的行为数据不是任何人都可以访问的。该属性就是用来表明哪些用户可以访问某些行为，同时指定其有效性。A.2xAPI 数据格式DB4403/T 198202110具体 xAPI 数据格式标准见表 A.2，接口示例见表 A.3。表 A.2xAPI 数据格式表中文简称数据项名类型长度约束解释/举例操作唯一标识CZWYBSC50MUUID操作者CZZC50Mjson 格式操作行为CZXWC50Mjson 格式操作对象CZDXC500Mjson 格式操作结果CZJGN11Ojson 格式上下文环境SXWHJC500Ojson 格式发生时间点FSSJC20M存储时间CCSJC20M授权SQC20Ojson 格式表 A.3xAPI 数据接口说明接口服务地址https:/域名地址/接口服务/v1/xAPIAction/userActionAcceptHttp 方法POST接口说明上报用户观看视频信息方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见 xAPI 数据格式表参数示例DataCZWYBS:d50ab77f-0d19-448d-a20a-8dc6ece9ec8e,CZZ:YHXM:王小川,YHLXBM:01,CZXW:CZXW:See,CZXWMC:观看视频,CZDX:CZDXBM:09,CZDXMC:咏鹅,CZJG:result:操作成功,SXWHJ:DLIP:219.134.104.255,YYMC:*系统,YYTGS:*（应用提供商名称）,SBLX:android 平板,SBH:9843b77f-954y-467h-i8t4-8dc6ece9ec7e,FSSJ:2020-10-12 11:34:23,CCSJ:2020-10-12 11:36:33SBLX:android 平板,SBH:9843b77f-954y-467h-i8t4-8dc6ece9ec7e,FSSJ:2020-10-12 11:34:23,CCSJ:2020-10-12 11:36:33TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,DB4403/T 198202111表 A.3xAPI 数据接口说明（续）返回值样例成功data：失败success：false，code:1，message：同步数据失败，data：DB4403/T 198202112附录B（规范性）数据交换设计B.1资源文件交换接口要求B.1.1上传文件接口要求上传文件接口应符合表 B.1 的要求。表 B.1上传文件接口要求上传文件接口参数参数说明https:/ip:端口/fileUploaduploadPath指定上传目录（根路径+相对路径）fileName上传文件名称userName使用账户appSecret授权密钥B.1.2下载文件接口要求下载文件接口应符合表 B.2 的要求。表 B.2下载文件接口要求上传文件接口参数参数说明https:/ip:端口/fileDownloadtargetFile文件下载路径绝对路径userName使用账户appSecret授权密钥B.1.3服务端返回状态服务端返回调用结果返回状态码见表 B.3。表 B.3服务端返回状态码状态码状态说明200调用成功400鉴权异常：用户不存在、用户密码错误401参数为空402下载文件不存在、上传时创建文件夹失败B.2交换服务方安全要求B.2.1交换事务标识应对每次数据交换指定具有唯一性的交换事务标识。DB4403/T 198202113B.2.2身份鉴别通过身份鉴别保证数据交换的安全性，要求如下：a)应对数据交换两端进行用户身份鉴别，确保数据交换两端身份的真实性；b)应采用如用户名/口令、一次性口令、数字证书、标识密码等技术实现交换两端的用户身份鉴别。B.2.3安全传输安全传输的要求如下：a)应采用密码技术保证数据传输通道安全，保证传输数据的保密性和完整性；b)应采用符合国家相关标准规定的数据加密方式与密码算法；c)应确保安全通道和身份鉴别过程的关联性；应保证通道安全协议执行过程中被认证方与需认证方身份信息具有真实对应关系，或者保证在已建立的安全通道内执行对使用方一端的身份鉴别；d)应在交换完成后清除通道历史缓存数据；e)应定期检查或评估数据流动通道的安全性和可靠性。B.2.4操作抗抵赖交换敏感类数据对操作扛抵赖性的要求如下：a)在交换敏感类数据时，应由数据提供方对发出数据和时间戳进行数字签名，数据使用方应校验数据提供方数字签名的合法性；b)在交换敏感类数据时，应由数据使用方对接收到的数据进行确认，确认消息应包括交换事务标识、交换数据摘要、时间戳、数据使用方的数字签名，宜包括接收方对数据质量的确认；数据提供方应校验数据使用方数字签名的合法性。B.2.5过程追溯B.2.5.1记录项要求应跟踪和记录数据交换全过程，确保溯源记录能满足溯源过程需要。记录项至少包括:a)本次数据交换事务唯一性标识；b)本次数据交换开始时间、结束时间；c)数据提供方对数据使用方的权限审核记录；d)数据提供方交付记录；e)数据传输过程记录，记录内容至少包括：端点标识、IP 地址、数据长度、传输时间等；f)若数据传输过程存在异常，应有异常记录、报警记录等；g)数据使用方对数据提供方的身份鉴别记录；h)数据使用方的接收状态记录；i)数据使用方的数据质量认定记录。B.2.5.2记录项保存时间数据交换记录日志应保存 6 个月以上，并保证敏感类数据交换记录日志的保密性。B.2.6数据质量控制数据交换中对数据质量控制的要求如下：DB4403/T 198202114a)应检验数据的质量，包括对数据格式和接口提出统一要求，并对获取数据是否满足要求做出认定；b)应定义空缺值、内容冲突、不合规约束等数据源质量评价条件并评价数据获取质量。DB4403/T 198202115附录C（资料性）数据交换接口示例C.1数据交换接口要求C.1.1要求服务数据交换采用RESTful风格API，数据格式统一采用JSON格式。C.1.2上报登录信息接口上报登录信息接口示例见表 C.1。表 C.1上报登录信息接口示例接口服务地址https:/域名地址/接口服务/v1/login/loginInfoAcceptHttp 方法POST接口说明上报用户登录信息方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见用户信息表单参数示例DataQXBM:440303,QXMC:罗湖区,YYMC:*系统,YYTGS:*（应用提供商名称）,XXBM:123,XXMC:深圳市*学校,NJMC:一年级,BJMC:三班,XJH:230345,YHBM:6547,YHMC:王小川,DLMC:zxt56432,YHLXBM:01,YHLXMC:学生,DLIP:219.134.104.255,SBH:863254036690765,DLSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，DB4403/T 198202116表 C.1上报登录信息接口示例（续）返回值样例失败code:1，message：同步数据失败，data：C.1.3教师开课信息交换接口教师开课信息交换接口示例见表 C.2。表 C.2教师开课信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/courseinformationHttp 方法POST接口说明教师开课信息交换方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见用户信息表单参数示例DataQXBM:440303,QXMC:罗湖区,YYMC:*系统,YYTGS:*（应用提供商名称）,XXBM:2300000001000413321,XXMC:深圳市*学校,YHBM:1500023100000003549,YHXM:李老师,KCBM:123456789,KCMC:数学公开课,XDBM:31,XDMC:普通初中,NJBM:16,NJMC:六年级,XKBM:110,XKMC:数学,KKZTMC:1,CZSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，DB4403/T 198202117表 C.2教师开课信息交换接口示例（续）返回值样例失败data：C.1.4教师备课信息交换接口教师备课信息交换接口示例见表 C.3。表 C.3教师备课信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/preparinginformationHttp 方法POST接口说明教师备课信息交换方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见用户信息表单参数示例DataXKMC:,数学NJMC:六年级,KBMC:数学六年级深圳版,ZJXH:1-2-3-4,ZJMC:第一章第二课第三节第四页,LSBM:123456789,LSXM:李老师,ZYBM:675,XXBM:1234567890,XXMC:深圳市*学校,SFTJFJ:1,CZSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.5教师授课信息交换接口教师授课信息交换接口示例见表 C.4。表 C.4教师授课信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/teachinginformationHttp 方法POSTDB4403/T 198202118表 C.4教师授课信息交换接口示例（续）接口说明教师授课信息交换方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见用户信息表单参数示例DataKCBM:89787793,KCMC:数学公开课,JSBM:88897899,JSMC:李老师,XKMC:数学,BJBM:978977988,BJMC:一班,NJMC:六年级,ZYBM:675,CZSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.6课堂互动信息交换接口课堂互动信息交换接口示例见表 C.5。表 C.5课堂互动信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/classroomInteractionHttp 方法POST接口说明教师课堂互动信息交换方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见用户信息表单参数示例DataHDBM:45678,QXBM:440303,QXMC:罗湖区,YYMC:*系统,YYTGS:*（应用提供商名称）,XXBM:1234567890,DB4403/T 198202119表 C.5课堂互动信息交换接口示例（续）C.1.7教师资源使用信息交换接口教师资源使用信息交换接口示例见表 C.6。表 C.6教师资源使用信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/resourceuseHttp 方法POST接口说明教师资源使用信息交换方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见用户信息表单参数示例DataQXBM:440303,QXMC:罗湖区,YYMC:*系统,参数示例DataXXMC:深圳市*学校,JSBM:123456789,JSXM:李老师,ZYBM:675,XDBM:31,XDMC:普通初中,NJBM:16,NJMC:六年级,XKBM:110,XKMC:数学,HDLXBM:2,HDLXMC:举手,BJBM:234324234,BJMC:七年级一班,KCBM:232234324,KCMC:数学公开课,HDHS:30,CZSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：DB4403/T 198202120表 C.6教师资源使用信息交换接口示例（续）参数示例DataYYTGS:*（应用提供商名称）,XXBM:2345678,XXMC:深圳市*学校,YHBM:123456789,YHLXBM:2,YHLXMC:教师,XDBM:31,XDMC:普通初中,XKBM:110,XKMC:数学,CZXWBM:2,CZXWMC:下载,ZYLY:2,ZYBM:758,ZYMC:数学讲义,CZSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.8教师作业布置信息交换接口教师作业布置信息交换接口示例见表 C.7。表 C.7教师作业布置信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/homeworkinformationHttp 方法POST接口说明教师作业布置信息交换方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见用户信息表单参数示例DataQXBM:440303,QXMC:罗湖区,YYMC:*系统,YYTGS:*（应用提供商名称）,DB4403/T 198202121表 C.7教师作业布置信息交换接口示例（续）参数示例DataXXBM:2345678,XXMC:深圳市*学校,JSBM:123456789,JSXM:李老师,XDBM:31,XDMC:普通初中,NJBM:16,NJMC:六年级,ZYLXBM:2,ZYLXMC:口语评测,ZYBM:223232322,STJBM:5743,ZYBT:口语评测练习一,BJBM:234324324,BJMC:六年级一班,ZYKSSJ:2020-10-12 11:34:23,ZYJZSJ:2020-10-12 11:34:23,ZYFBSJ:2020-10-12 11:34:23,CZSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.9作业报告信息交换接口作业报告信息交换接口示例见表 C.8。表 C.8作业报告信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/homeworkreportHttp 方法POST接口说明作业报告信息交换方法参数说明名称Data类型String说明用户登录信息的 JSON 字符串，具体字段详见用户信息表单参数示例DataZYBM:332423423,DB4403/T 198202122表 C.8作业报告信息交换接口示例（续）参数示例DataXJH:23423423,XSBM:432423423,LSBM:45435345345,BJBM:53524234,XKBM:110,ZYLX:2,ZYBM:口语评测练习,SFZYKGT:1,ZYWCSJ:2020-10-12 11:34:23,ZYTJSJ:2020-10-12 11:34:23,SFTJ:1,MF:100,DF:80,KGTDF:20,ZGTDF:60,WCTS:11,BJPM:5,ZFPM:5,ZYDZZT:1,ZYDZCS:2,ZYPGRXM:李老师,ZYPGRBM:77635435,ZYPGZT:1,ZYPGSJ:2020-10-12 11:34:23,ZYPY:多多努力,ZDSC:243,YYMC:*系统,YYTGS:*（应用提供商名称）,SFCZ:1TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.10作业答题信息交换接口作业答题信息交换接口示例见表 C.9。DB4403/T 198202123表 C.9作业答题信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/homework/homeworkDetailHttp 方法POST接口说明作业作答信息交换方法参数说明名称Data类型String说明作业作答信息的 JSON 字符串，具体字段详见做作业作答信息表单参数示例DataZYBM:563,ZYMC:第一单元作业,XSBM:467,XSXM:王小川,STJBM:824,TMBM:84563,XSDA:A,DF:0,MF:2,ZDSC:5,YYMC:*系统,YYTGS:*（应用提供商名称）,CYSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.11课堂测验信息交换接口课堂测验信息交换接口示例见表 C.10。表 C.10课堂测验信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/courseTestTaskHttp 方法POST接口说明作业作答信息交换方法参数说明名称Data类型String说明课堂测验信息的 JSON 字符串，具体字段详见课堂测验信息表单参数示例DataCYBM:843,DB4403/T 198202124表 C.10课堂测验信息交换接口示例（续）参数示例DataCYMC:语文第一次课堂测验,JSXM:王萧,JSBM:564,STJBM:824,BJMC:二班,BJBM:836,NJBM:21,XXMC:深圳市*学校,XXBM:457,YYMC:*系统,YYTGS:*（应用提供商名称）,CYSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.12课堂测验报告信息交换接口课堂测验报告信息交换接口示例见表 C.11。表 C.11课堂测验报告信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/course/courseTestReportHttp 方法POST接口说明课堂测验报告信息交换方法参数说明名称Data类型String说明课堂测验报告信息的 JSON 字符串，具体字段详见课堂测验报告信息表单参数示例DataCYBM:843,CYMC:语文第一次课堂测验,XSBM:467,XSXM:王小川,STJBM:824,TMBM:84563,XSDA:A,DF:0,DB4403/T 198202125表 C.11课堂测验报告信息交换接口示例（续）参数示例DataMF:2,ZDSC:5,YYMC:*系统,YYTGS:*（应用提供商名称）,CYSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.13试题集信息交换接口试题集信息交换接口示例见表 C.12。表 C.12试题集信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/topic/topicSetInfoHttp 方法POST接口说明试题集信息交换方法参数说明名称Data类型String说明试题集信息的 JSON 字符串，具体字段详见试题集信息表单参数示例DataSTJBM:824,STJMC:第一单元课堂测验题集,TMBM:84563,XKBM:110,XDBM:21,YYTGS:*（应用提供商名称）,CYSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，DB4403/T 198202126表 C.12试题集信息交换接口示例（续）返回值样例失败data：C.1.14题目信息交换接口题目信息交换接口示例见表 C.13。表 C.13题目信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/topic/topicInfoHttp 方法POST接口说明题目信息交换方法参数说明名称Data类型String说明题目信息的 JSON 字符串，具体字段详见题目信息表单参数示例DataTMBM:84563,ZSDBM:5468,XKBM:110,XDBM:21,TMND:0.8,TMQFD:0.8,TMLXMC:选择题,TMDA:D,YYTGS:*（应用提供商名称）,CYSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.15知识点信息交换接口知识点信息交换接口示例见表 C.14。表 C.14知识点信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/knowledge/knowledgePointsInfoHttp 方法POST接口说明题目信息交换方法参数说明名称DataDB4403/T 198202127表 C.14知识点信息交换接口示例（续）方法参数说明类型String说明知识点信息的 JSON 字符串，具体字段详见知识点信息表单参数示例DataXKBM:110,XKMC:数学,XDBM:21,XDMC:小学,YYTGS:*（应用提供商名称）,ZSDBM:456,ZSDMC:乘法,QZZSDBM:加法,QZZSDMC:346,HZZSDBM:除法,HZZSDMC:578,ZSDXH:35,ZSDCJ:2,CYSJ:2020-10-12 11:34:23TokenA876CA03-7392-3971-7832-3D65DD0DRT3T返回值样例成功success：true,code:0,message：同步数据成功,data：失败success：false，code:1，message：同步数据失败，data：C.1.16教材课本信息交换接口教材课本使用信息交换接口示例见表 C.15。表 C.15教材课本信息交换接口示例接口服务地址https:/域名地址/接口服务/v1/book/bookInfoHttp 方法POST接口说明教材课本信息交换方法参数说明名称Data类型String说明教材课本信息的 JSON 字符串，具体字段详见教材课本信息表单参数示例DataKBBM:356,KBMC:人教版一年级语文课本,CBSBM:01,CBSMC:人民出版社,DB4403/T 198202128表