DB4403-T 198-2021 課堂教學(xué)行為數(shù)據(jù)交換規(guī)范

ICS35.240.99

CCSA18

DB4403

深圳市地方標(biāo)準(zhǔn)

DB4403/T198—2021

課堂教學(xué)行為數(shù)據(jù)交換規(guī)范

Dataexchangespecificationforclassroomteachingbehavior

2021-11-16發(fā)布2021-12-01實(shí)施

深圳市市場監(jiān)督管理局發(fā)布

DB4403/T198—2021

課堂教學(xué)行為數(shù)據(jù)交換規(guī)范

1范圍

本文件規(guī)定了課堂教學(xué)行為的框架與課堂教學(xué)行為數(shù)據(jù)交換的基本要求、交換要求和數(shù)據(jù)要求。

本文件適用于深圳市中小學(xué)市、區(qū)、校三級課堂教學(xué)行為信息的數(shù)據(jù)交換，支撐深圳市實(shí)現(xiàn)對教學(xué)

行為數(shù)據(jù)的記錄、追蹤和分析以及開展教學(xué)過程性評價(jià)，指導(dǎo)差異化教學(xué)。

2規(guī)范性引用文件

本文件沒有規(guī)范性引用文件。

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1

課堂classroom

中小學(xué)教師進(jìn)行教學(xué)活動(dòng)的物理空間。

3.2

教學(xué)行為instructionalbehavior

教學(xué)活動(dòng)中的一系列圍繞教學(xué)內(nèi)容展開的教與學(xué)行為。

3.3

數(shù)據(jù)交換dataexchange

數(shù)據(jù)采集及交換的技術(shù)行為。

3.4

學(xué)習(xí)者learner

依靠學(xué)習(xí)技術(shù)系統(tǒng)獲取知識或技能的個(gè)體。

3.5

教師teacher

依靠學(xué)習(xí)技術(shù)系統(tǒng)傳遞知識或技能的個(gè)體。

3.6

學(xué)習(xí)行為learningbehavior

學(xué)習(xí)活動(dòng)中的一系列行為。

1

DB4403/T198—2021

3.7

知識點(diǎn)knowledgepoint

知識、理論、道理、思想等的相對獨(dú)立的最小單元，是課程中信息傳遞的基本單元。

3.8

互動(dòng)類型interacttype

教師與學(xué)習(xí)者借助技術(shù)手段進(jìn)行的交互方式。

4課堂教學(xué)行為框架

4.1課堂教學(xué)行為框架

框架包括課堂教學(xué)行為、課堂學(xué)習(xí)行為、課堂教育資源，見圖1。

圖1課堂教學(xué)行為框架

4.2課堂教學(xué)行為

課堂教學(xué)行為分為：

——教學(xué)準(zhǔn)備行為：記錄教師課前的相關(guān)教學(xué)準(zhǔn)備行為，包括登錄和備課等行為；

——教學(xué)組織行為：記錄教師組織教學(xué)的行為，包括開課、授課，下發(fā)練習(xí)、測試和作業(yè)等行為；

——課堂交互行為：記錄教師引導(dǎo)、激勵(lì)學(xué)生學(xué)習(xí)的行為，發(fā)起討論、投票、搶答、隨機(jī)選人作答、

全班作答、資源分享、教學(xué)答疑和輔導(dǎo)等行為；

——評價(jià)反饋行為：記錄教師對學(xué)習(xí)者評價(jià)的行為，包括查看學(xué)生的作業(yè)、作品、測試和考試，評

價(jià)學(xué)生的作業(yè)等行為。

4.3課堂教育資源

課堂教育資源分為：

——教學(xué)資源：教師上課使用的教材資源，包括電子書、備課、授課等教學(xué)活動(dòng)中使用的資源；

——試題資源：考試、練習(xí)、測驗(yàn)中使用的題目資源。

2

DB4403/T198—2021

4.4課堂學(xué)習(xí)行為

課堂學(xué)習(xí)行為分為（數(shù)據(jù)應(yīng)符合附錄A的規(guī)定）：

——學(xué)習(xí)軌跡行為：記錄學(xué)習(xí)者的操作行為鏈（點(diǎn)擊流），包括登錄、退出、提交等對系統(tǒng)頁面操

作的行為；

——資源學(xué)習(xí)行為：記錄學(xué)習(xí)者學(xué)習(xí)的資源以及對資源進(jìn)行的操作，包括瀏覽、使用、上傳、下載

學(xué)習(xí)資源等行為；

——課堂交互行為：記錄學(xué)習(xí)者與其他學(xué)習(xí)者、教師、管理員的交流行為，包括發(fā)起提問、資源分

享等行為；

——評價(jià)反思行為：記錄學(xué)習(xí)者參與測試、評價(jià)的行為，包括完成并提交練習(xí)、課堂實(shí)驗(yàn)、作業(yè)和

測試，完成互評和錯(cuò)題訂正，對自我、同伴、教師進(jìn)行評價(jià)等行為。

5總體要求

5.1數(shù)據(jù)項(xiàng)組成

元數(shù)據(jù)結(jié)構(gòu)如下：

——中文簡稱：所用的數(shù)據(jù)元素的名稱，具有語義，面向用戶；

——數(shù)據(jù)項(xiàng)名：通常由中文簡稱的漢語拼音首字母（大寫）組成，與中文簡稱一一對應(yīng)，宜在實(shí)際

數(shù)據(jù)結(jié)構(gòu)中采用；

——類型：數(shù)據(jù)項(xiàng)容納的數(shù)據(jù)類型，本文件在數(shù)據(jù)項(xiàng)中簡稱其為類型（一種屬性）；

——長度：數(shù)據(jù)項(xiàng)能容納的最大字符數(shù)（一種屬性）；

——約束：數(shù)據(jù)項(xiàng)約束狀態(tài)的描述，即必備數(shù)據(jù)項(xiàng)或可選數(shù)據(jù)項(xiàng)（一種屬性）；

——解釋/舉例：數(shù)據(jù)項(xiàng)屬性的說明或舉例。

5.2數(shù)據(jù)類型

5.2.1字符型

字符型為C，在信息系統(tǒng)中取用時(shí)，可以是可變長度。

5.2.2數(shù)值型

數(shù)值型為N，可參與運(yùn)算。

5.2.3二進(jìn)制類型

二進(jìn)制類型為B，宜在照片或超長文本使用。

5.2.4文本型

文本型為T，用于數(shù)量較多的文字描述。數(shù)據(jù)值長度大于1000字符時(shí)應(yīng)采用文本型。

5.3約束

數(shù)據(jù)約束條件有可選數(shù)據(jù)元素O和必備數(shù)據(jù)元素M兩種。

5.4時(shí)間格式定義

系統(tǒng)定義的時(shí)間格式為年-月-日時(shí)：分：秒（yyyy-MM-ddHH:mm:ss）。

3

DB4403/T198—2021

5.5數(shù)據(jù)傳輸方式

結(jié)構(gòu)化數(shù)據(jù)采取文本形式傳輸；非結(jié)構(gòu)化數(shù)據(jù)（如視頻類、音頻類）采用文件方式進(jìn)行數(shù)據(jù)傳輸，

采取二進(jìn)制形式存儲(chǔ)。

6交換要求

6.1基本要求

6.1.1數(shù)據(jù)交換對象是深圳市、區(qū)、校三級課堂教學(xué)信息系統(tǒng)的課堂教學(xué)行為數(shù)據(jù)。數(shù)據(jù)交換類別包

括結(jié)構(gòu)化數(shù)據(jù)、非結(jié)構(gòu)化數(shù)據(jù)。其中，視頻、圖片、音頻、文檔類等附件數(shù)據(jù)是非結(jié)構(gòu)化數(shù)據(jù)，文本信

息類、數(shù)據(jù)庫表數(shù)據(jù)是結(jié)構(gòu)化數(shù)據(jù)。

6.1.2數(shù)據(jù)交換可采用不同的數(shù)據(jù)交換方式進(jìn)行（具體交換設(shè)計(jì)應(yīng)符合附錄B的規(guī)定），包括但不限于：

a)庫表交換；

b)資源文件交換；

c)服務(wù)接口交換。

6.2庫表交換

基于數(shù)據(jù)庫表結(jié)構(gòu)形式進(jìn)行數(shù)據(jù)交換，適用于大量歷史數(shù)據(jù)的交互或適用數(shù)據(jù)增量更新頻繁的數(shù)據(jù)

交換，結(jié)構(gòu)如圖2所示。

圖2基于數(shù)據(jù)庫的交換方式

6.3資源文件交換

6.3.1通過文件交換的形式進(jìn)行數(shù)據(jù)交換，適用于非結(jié)構(gòu)化資源或更新頻率比較緩慢的結(jié)構(gòu)化資源的

數(shù)據(jù)交換。結(jié)構(gòu)如圖3所示。

4

DB4403/T198—2021

圖3基于文件的交換方式

6.3.2資源文件交換方式基于前置機(jī)進(jìn)行網(wǎng)絡(luò)安全隔離，文件上傳和下載接口協(xié)議使用HTTPS協(xié)議，

通過提供訪問的URL，用戶使用HTTPPOST方法發(fā)送請求。

6.4服務(wù)接口交換

6.4.1將數(shù)據(jù)服務(wù)封裝成接口，供數(shù)據(jù)使用方調(diào)用，適用于小數(shù)據(jù)量、實(shí)時(shí)性要求較高的數(shù)據(jù)交換，

結(jié)構(gòu)如圖4所示。

圖4服務(wù)接口交換方式

6.4.2服務(wù)數(shù)據(jù)交換采用RESTful風(fēng)格API，數(shù)據(jù)格式統(tǒng)一采用JSON格式，接口示例見附錄C。接口

協(xié)議采用Https，接口編碼采用UTF-8。安全驗(yàn)證應(yīng)根據(jù)授權(quán)用戶和密碼產(chǎn)生的隨機(jī)Token來訪問各API。

接口數(shù)據(jù)的返回格式為JSON格式字符串，接口返回值數(shù)據(jù)格式應(yīng)符合表1的要求。

表1數(shù)據(jù)格式

JSON變量說明

Success調(diào)用接口操作成功標(biāo)志，boolean值true、false

Code返回結(jié)果狀態(tài)標(biāo)識，0代表成功，1代表失敗

5

DB4403/T198—2021

表1數(shù)據(jù)格式（續(xù)）

JSON變量說明

Message返回結(jié)果的文字說明

Data返回的結(jié)果數(shù)據(jù)

7數(shù)據(jù)要求

7.1課堂教學(xué)行為數(shù)據(jù)基于框架拆解，主要包括但不限于以下數(shù)據(jù)：

a)用戶登錄信息，

b)教師開課信息，

c)教師備課信息，

d)教師授課信息，

e)課堂互動(dòng)信息，

f)資源使用信息，

g)作業(yè)布置信息，

h)作業(yè)報(bào)告信息，

i)作業(yè)答題信息，

j)課堂測驗(yàn)信息，

k)課堂測驗(yàn)報(bào)告，

l)試題集信息，

m)題目信息，

n)知識點(diǎn)信息，

o)教材課本信息，

p)教學(xué)資源信息，

q)學(xué)習(xí)行為信息。

7.2元數(shù)據(jù)應(yīng)符合表2所示數(shù)據(jù)交換索引。

表2數(shù)據(jù)交換索引表

序號數(shù)據(jù)類別數(shù)據(jù)信息具體數(shù)據(jù)要求

1學(xué)段信息見D.1

2年級信息見D.2

3學(xué)科信息見D.3

4基礎(chǔ)數(shù)據(jù)行政區(qū)信息見D.4

5學(xué)習(xí)者信息見D.5

6操作行為信息見D.6

7互動(dòng)類型信息見D.7

6

DB4403/T198—2021

表2數(shù)據(jù)交換索引表（續(xù)）

序號數(shù)據(jù)類別數(shù)據(jù)信息具體數(shù)據(jù)要求

8基礎(chǔ)數(shù)據(jù)資源來源信息見D.8

9用戶登錄信息見E.1

10教師開課信息見E.2

11教師備課信息見E.3

12教師授課信息見E.4

13課堂互動(dòng)信息見E.5

14資源使用信息見E.6

15作業(yè)布置信息見E.7

16作業(yè)報(bào)告信息見E.8

課堂教學(xué)

17作業(yè)答題信息見E.9

行為數(shù)據(jù)

18課堂測驗(yàn)信息見E.10

19課堂測驗(yàn)報(bào)告見E.11

20試題集信息見E.12

21題目信息見E.13

22知識點(diǎn)信息見E.14

23教材課本信息見E.15

24教學(xué)資源信息見E.16

25學(xué)習(xí)行為信息見C.2

7

DB4403/T198—2021

附錄A

（規(guī)范性）

學(xué)習(xí)行為xAPI規(guī)范

A.1xAPI規(guī)范框架

A.1.1xAPI規(guī)范框架包括操作ID，操作者，動(dòng)作，對象，結(jié)果等，如圖A.1。

圖A.1xAPI用戶學(xué)習(xí)行為框架

A.1.2用戶學(xué)習(xí)行為元素

A.1.2.1操作ID

操作標(biāo)示符。操作ID是一個(gè)唯一標(biāo)識符，在一些不必要的場合可以省略。

A.1.2.2Actor

操作者。每一個(gè)學(xué)習(xí)行為、每一個(gè)學(xué)習(xí)活動(dòng)，都應(yīng)有一個(gè)提供者、參與者，代表的是誰在學(xué)習(xí)、是

由誰發(fā)起了這個(gè)活動(dòng)。

A.1.2.3Verb

動(dòng)作。表示操作者的具體操作行為。具體動(dòng)詞及其語義如表A.1。

表A.1xAPI動(dòng)作定義

動(dòng)作描述

Answered回答

Vote投票

Asked提問

Attended參加

Commented評論

Completed完成

Login-out退出

Start開始

Experienced經(jīng)歷

Failed失敗

Input輸入

8

DB4403/T198—2021

表A.1xAPI動(dòng)作定義（續(xù)）

動(dòng)作描述

Initialized初始化

Interacted交互

Launched發(fā)布

Passed通過

Failed未通過

Mastered掌握

See觀看

Preferred偏好

Registered注冊

Login-in登錄

Meeting會(huì)議

Responded響應(yīng)

Resumed繼續(xù)

Scored得分

Shared分享

Suspended暫停

Terminated結(jié)束

A.1.2.4Object

對象。對象中包含有兩個(gè)子屬性：操作對象編碼和操作對象名稱。

A.1.2.5Result

結(jié)果。該屬性是可以擴(kuò)展的，它主要描述一些動(dòng)作結(jié)果，如得分、通過與否和完成進(jìn)度等。

A.1.2.6Context

上下文環(huán)境。該屬性提供一些活動(dòng)中的上下文信息,包括但不限于廠商名稱、應(yīng)用名稱、設(shè)備IP、

設(shè)備類型、設(shè)備型號等。

A.1.2.7TimeStamp

活動(dòng)發(fā)生時(shí)間。

A.1.2.8StoredTime

記錄存儲(chǔ)時(shí)間。

A.1.2.9Authority

授權(quán)。出于對安全性的考慮，通常存儲(chǔ)的行為數(shù)據(jù)不是任何人都可以訪問的。該屬性就是用來表明

哪些用戶可以訪問某些行為，同時(shí)指定其有效性。

A.2xAPI數(shù)據(jù)格式

9

DB4403/T198—2021

具體xAPI數(shù)據(jù)格式標(biāo)準(zhǔn)見表A.2，接口示例見表A.3。

表A.2xAPI數(shù)據(jù)格式表

中文簡稱數(shù)據(jù)項(xiàng)名類型長度約束解釋/舉例

操作唯一標(biāo)識CZWYBSC50MUUID

操作者CZZC50Mjson格式

操作行為CZXWC50Mjson格式

操作對象CZDXC500Mjson格式

操作結(jié)果CZJGN11Ojson格式

上下文環(huán)境SXWHJC500Ojson格式

發(fā)生時(shí)間點(diǎn)FSSJC20M—

存儲(chǔ)時(shí)間CCSJC20M—

授權(quán)SQC20Ojson格式

表A.3xAPI數(shù)據(jù)接口說明

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/xAPIAction/userActionAccept

Http方法POST

接口說明上報(bào)用戶觀看視頻信息

名稱Data

方法參數(shù)說明類型String

說明用戶登錄信息的JSON字符串，具體字段詳見xAPI數(shù)據(jù)格式表

Data{CZWYBS":"d50ab77f-0d19-448d-a20a-8dc6ece9ec8e",

"CZZ":"{\"YHXM\":\"王小川\",\"YHLXBM\":\"01\"}",

"CZXW":"{\"CZXW\":\"See\",\"CZXWMC\":\"觀看視頻\"}",

"CZDX":"{\"CZDXBM\":\"09\",\"CZDXMC\":\"詠鵝\"}",

"CZJG":"{\"result\":\"操作成功\"}",

"SXWHJ":"{\"DLIP\":\"55\",

\"YYMC\":\"***系統(tǒng)\"\",

\"YYTGS\":\"***（應(yīng)用提供商名稱）\",

參數(shù)示例\"SBLX\":\"android平板\",

\"SBH\":\"9843b77f-954y-467h-i8t4-8dc6ece9ec7e\"}",

"FSSJ":"2020-10-1211:34:23",

"CCSJ":"2020-10-1211:36:33"}

\"SBLX\":\"android平板\",

\"SBH\":\"9843b77f-954y-467h-i8t4-8dc6ece9ec7e\"}",

"FSSJ":"2020-10-1211:34:23",

"CCSJ":"2020-10-1211:36:33"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

返回值樣例成功"code":0,

"message"："同步數(shù)據(jù)成功",

10

DB4403/T198—2021

表A.3xAPI數(shù)據(jù)接口說明（續(xù)）

成功"data"：[]}

{"success"：false，

返回值樣例"code":1，

失敗

"message"："同步數(shù)據(jù)失敗"，

"data"：[]}

11

DB4403/T198—2021

附錄B

（規(guī)范性）

數(shù)據(jù)交換設(shè)計(jì)

B.1資源文件交換接口要求

B.1.1上傳文件接口要求

上傳文件接口應(yīng)符合表B.1的要求。

表B.1上傳文件接口要求

上傳文件接口參數(shù)參數(shù)說明

uploadPath指定上傳目錄（根路徑+相對路徑）

https://ip:端口fileName上傳文件名稱

/fileUploaduserName使用賬戶

appSecret授權(quán)密鑰

B.1.2下載文件接口要求

下載文件接口應(yīng)符合表B.2的要求。

表B.2下載文件接口要求

上傳文件接口參數(shù)參數(shù)說明

targetFile文件下載路徑絕對路徑

https://ip:端口

userName使用賬戶

/fileDownload

appSecret授權(quán)密鑰

B.1.3服務(wù)端返回狀態(tài)

服務(wù)端返回調(diào)用結(jié)果返回狀態(tài)碼見表B.3。

表B.3服務(wù)端返回狀態(tài)碼

狀態(tài)碼狀態(tài)說明

200調(diào)用成功

400鑒權(quán)異常：用戶不存在、用戶密碼錯(cuò)誤

401參數(shù)為空

402下載文件不存在、上傳時(shí)創(chuàng)建文件夾失敗

B.2交換服務(wù)方安全要求

B.2.1交換事務(wù)標(biāo)識

應(yīng)對每次數(shù)據(jù)交換指定具有唯一性的交換事務(wù)標(biāo)識。

12

DB4403/T198—2021

B.2.2身份鑒別

通過身份鑒別保證數(shù)據(jù)交換的安全性，要求如下：

a)應(yīng)對數(shù)據(jù)交換兩端進(jìn)行用戶身份鑒別，確保數(shù)據(jù)交換兩端身份的真實(shí)性；

b)應(yīng)采用如用戶名/口令、一次性口令、數(shù)字證書、標(biāo)識密碼等技術(shù)實(shí)現(xiàn)交換兩端的用戶身份鑒

別。

B.2.3安全傳輸

安全傳輸?shù)囊笕缦拢?/p>

a)應(yīng)采用密碼技術(shù)保證數(shù)據(jù)傳輸通道安全，保證傳輸數(shù)據(jù)的保密性和完整性；

b)應(yīng)采用符合國家相關(guān)標(biāo)準(zhǔn)規(guī)定的數(shù)據(jù)加密方式與密碼算法；

c)應(yīng)確保安全通道和身份鑒別過程的關(guān)聯(lián)性；應(yīng)保證通道安全協(xié)議執(zhí)行過程中被認(rèn)證方與需認(rèn)證

方身份信息具有真實(shí)對應(yīng)關(guān)系，或者保證在已建立的安全通道內(nèi)執(zhí)行對使用方一端的身份鑒

別；

d)應(yīng)在交換完成后清除通道歷史緩存數(shù)據(jù)；

e)應(yīng)定期檢查或評估數(shù)據(jù)流動(dòng)通道的安全性和可靠性。

B.2.4操作抗抵賴

交換敏感類數(shù)據(jù)對操作扛抵賴性的要求如下：

a)在交換敏感類數(shù)據(jù)時(shí)，應(yīng)由數(shù)據(jù)提供方對發(fā)出數(shù)據(jù)和時(shí)間戳進(jìn)行數(shù)字簽名，數(shù)據(jù)使用方應(yīng)校驗(yàn)

數(shù)據(jù)提供方數(shù)字簽名的合法性；

b)在交換敏感類數(shù)據(jù)時(shí)，應(yīng)由數(shù)據(jù)使用方對接收到的數(shù)據(jù)進(jìn)行確認(rèn)，確認(rèn)消息應(yīng)包括交換事務(wù)標(biāo)

識、交換數(shù)據(jù)摘要、時(shí)間戳、數(shù)據(jù)使用方的數(shù)字簽名，宜包括接收方對數(shù)據(jù)質(zhì)量的確認(rèn)；數(shù)據(jù)

提供方應(yīng)校驗(yàn)數(shù)據(jù)使用方數(shù)字簽名的合法性。

B.2.5過程追溯

B.2.5.1記錄項(xiàng)要求

應(yīng)跟蹤和記錄數(shù)據(jù)交換全過程，確保溯源記錄能滿足溯源過程需要。記錄項(xiàng)至少包括:

a)本次數(shù)據(jù)交換事務(wù)唯一性標(biāo)識；

b)本次數(shù)據(jù)交換開始時(shí)間、結(jié)束時(shí)間；

c)數(shù)據(jù)提供方對數(shù)據(jù)使用方的權(quán)限審核記錄；

d)數(shù)據(jù)提供方交付記錄；

e)數(shù)據(jù)傳輸過程記錄，記錄內(nèi)容至少包括：端點(diǎn)標(biāo)識、IP地址、數(shù)據(jù)長度、傳輸時(shí)間等；

f)若數(shù)據(jù)傳輸過程存在異常，應(yīng)有異常記錄、報(bào)警記錄等；

g)數(shù)據(jù)使用方對數(shù)據(jù)提供方的身份鑒別記錄；

h)數(shù)據(jù)使用方的接收狀態(tài)記錄；

i)數(shù)據(jù)使用方的數(shù)據(jù)質(zhì)量認(rèn)定記錄。

B.2.5.2記錄項(xiàng)保存時(shí)間

數(shù)據(jù)交換記錄日志應(yīng)保存6個(gè)月以上，并保證敏感類數(shù)據(jù)交換記錄日志的保密性。

B.2.6數(shù)據(jù)質(zhì)量控制

數(shù)據(jù)交換中對數(shù)據(jù)質(zhì)量控制的要求如下：

13

DB4403/T198—2021

a)應(yīng)檢驗(yàn)數(shù)據(jù)的質(zhì)量，包括對數(shù)據(jù)格式和接口提出統(tǒng)一要求，并對獲取數(shù)據(jù)是否滿足要求做出認(rèn)

定；

b)應(yīng)定義空缺值、內(nèi)容沖突、不合規(guī)約束等數(shù)據(jù)源質(zhì)量評價(jià)條件并評價(jià)數(shù)據(jù)獲取質(zhì)量。

14

DB4403/T198—2021

附錄C

（資料性）

數(shù)據(jù)交換接口示例

C.1數(shù)據(jù)交換接口要求

C.1.1要求

服務(wù)數(shù)據(jù)交換采用RESTful風(fēng)格API，數(shù)據(jù)格式統(tǒng)一采用JSON格式。

C.1.2上報(bào)登錄信息接口

上報(bào)登錄信息接口示例見表C.1。

表C.1上報(bào)登錄信息接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/login/loginInfoAccept

Http方法POST

接口說明上報(bào)用戶登錄信息

名稱Data

方法參數(shù)說明類型String

說明用戶登錄信息的JSON字符串，具體字段詳見用戶信息表單

{"QXBM":440303,

"QXMC":"羅湖區(qū)",

"YYMC":"***系統(tǒng)",

"YYTGS":"***"（應(yīng)用提供商名稱）,

"XXBM":123,

"XXMC":"深圳市**學(xué)校",

"NJMC":"一年級",

"BJMC":"三班",

Data"XJH":"230345",

參數(shù)示例

"YHBM":6547,

"YHMC":"王小川",

"DLMC":"zxt56432",

"YHLXBM":"01",

"YHLXMC":"學(xué)生",

"DLIP":"55,

"SBH":"863254036690765",

"DLSJ":"2020-10-1211:34:23"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

"code":0,

成功

返回值樣例"message"："同步數(shù)據(jù)成功",

"data"：[]}

失敗{"success"：false，

15

DB4403/T198—2021

表C.1上報(bào)登錄信息接口示例（續(xù)）

"code":1，

返回值樣例失敗"message"："同步數(shù)據(jù)失敗"，

"data"：[]}

C.1.3教師開課信息交換接口

教師開課信息交換接口示例見表C.2。

表C.2教師開課信息交換接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/course/courseinformation

Http方法POST

接口說明教師開課信息交換

名稱Data

方法參數(shù)說明類型String

說明用戶登錄信息的JSON字符串，具體字段詳見用戶信息表單

{"QXBM":440303,

"QXMC":"羅湖區(qū)",

"YYMC":"***系統(tǒng)",

"YYTGS":"***"（應(yīng)用提供商名稱）,

"XXBM":2300000001000413321,

"XXMC":"深圳市**學(xué)校",

"YHBM":"1500023100000003549",

"YHXM":"李老師",

"KCBM":"123456789",

Data

參數(shù)示例"KCMC":"數(shù)學(xué)公開課",

"XDBM":"31",

"XDMC":"普通初中",

"NJBM":"16",

"NJMC":"六年級",

"XKBM":"110",

"XKMC":"數(shù)學(xué)",

"KKZTMC":"1",

"CZSJ":"2020-10-1211:34:23"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

"code":0,

成功

"message"："同步數(shù)據(jù)成功",

返回值樣例"data"：[]}

{"success"：false，

失敗"code":1，

"message"："同步數(shù)據(jù)失敗"，

16

DB4403/T198—2021

表C.2教師開課信息交換接口示例（續(xù)）

返回值樣例失敗"data"：[]}

C.1.4教師備課信息交換接口

教師備課信息交換接口示例見表C.3。

表C.3教師備課信息交換接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/course/preparinginformation

Http方法POST

接口說明教師備課信息交換

名稱Data

方法參數(shù)說明類型String

說明用戶登錄信息的JSON字符串，具體字段詳見用戶信息表單

{"XKMC":,"數(shù)學(xué)"

"NJMC":"六年級",

"KBMC":"數(shù)學(xué)六年級深圳版",

"ZJXH":"1-2-3-4",

"ZJMC":"第一章第二課第三節(jié)第四頁",

"LSBM":"123456789",

Data

參數(shù)示例"LSXM":"李老師",

"ZYBM":"675",

"XXBM":"1234567890",

"XXMC":"深圳市**學(xué)校",

"SFTJFJ":"1",

"CZSJ":"2020-10-1211:34:23"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

"code":0,

成功

"message"："同步數(shù)據(jù)成功",

"data"：[]}

返回值樣例

{"success"：false，

"code":1，

失敗

"message"："同步數(shù)據(jù)失敗"，

"data"：[]}

C.1.5教師授課信息交換接口

教師授課信息交換接口示例見表C.4。

表C.4教師授課信息交換接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/course/teachinginformation

Http方法POST

17

DB4403/T198—2021

表C.4教師授課信息交換接口示例（續(xù)）

接口說明教師授課信息交換

名稱Data

方法參數(shù)說明類型String

說明用戶登錄信息的JSON字符串，具體字段詳見用戶信息表單

{"KCBM":89787793,

"KCMC":"數(shù)學(xué)公開課",

"JSBM":"88897899",

"JSMC":"李老師",

"XKMC":"數(shù)學(xué)",

Data

參數(shù)示例"BJBM":"978977988",

"BJMC":"一班",

"NJMC":"六年級",

"ZYBM":"675",

"CZSJ":"2020-10-1211:34:23"}

TokenA876CA03-7392-3971-7832-3D65DD0DRT3T

{"success"：true,

"code":0,

成功

"message"："同步數(shù)據(jù)成功",

"data"：[]}

返回值樣例

{"success"：false，

"code":1，

失敗

"message"："同步數(shù)據(jù)失敗"，

"data"：[]}

C.1.6課堂互動(dòng)信息交換接口

課堂互動(dòng)信息交換接口示例見表C.5。

表C.5課堂互動(dòng)信息交換接口示例

接口服務(wù)地址https://{域名地址}/{接口服務(wù)}/v1/course/classroomInteraction

Http方法POST

接口說明教師課堂互動(dòng)信息交換

名稱Data

方法參數(shù)說明類型String

說明用戶登錄信息的JSON字符串，具體字段詳見用戶信息表單

{"HDBM":45678,

"QXBM":"440303",

"QXMC":"羅湖區(qū)",

參數(shù)示例Data

"YYMC":"***系統(tǒng)",

"YYTGS":"***"（應(yīng)用提供商名稱）,

"XXBM":"1234567890",

18

DB4403/T198—2021

表C.5課堂互動(dòng)信息交換接口示例（續(xù)）

"XXMC":"深圳市**學(xué)校",

"JSBM":"123456789",

"JSXM":"李老師",

"ZYBM":"675",

"XDBM":"31",

"XDMC":"普通初中",

"NJBM":"16",

"NJMC":"六年級",

"XKBM":"110",

Data

參數(shù)示例"XKMC":"數(shù)學(xué)",

"HDLXBM":"2",

"HDLXMC":"舉手",

"BJBM":"234324234",

"BJMC":"七年級一班",

"KCBM":"232234324",

"KCMC":"數(shù)