DB4401-T 223-2023 教育電子學習資源數(shù)據(jù)接口規(guī)范

35.240.01

DB4401 DB4401/T

223—2023教育電子學習資源數(shù)據(jù)接口規(guī)范Specification

of

data

interface

for

educational

e-learning

resources2023-

-

發(fā)布 2023

-

-

實施廣州市市場監(jiān)督管理局 發(fā)

布

4.1

4.2

5.1

5.2

5.3

5.4

5.5

5.6

API

sha1

加密代碼實現(xiàn)(Java)

本文件按照

1.12020《標準化工作導則 第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定

4880.1—2005

7408—2005

28825—2012

3.1

educational

resources3.2

interface

4.1

0607—2017

該資源的描述的名字20該資源知識內(nèi)容所使用的人類語言主要種類，語種分類代碼從《中國圖書館圖書分

4880.1—2005“fr-CA”

正式標題之外的其他以文本方式對資源內(nèi)用以描述資源主要內(nèi)該資源所屬學科課文mode該資源所適用的學習行為，體現(xiàn)學生在自主性、探究性和合作該資源的主要使用者，最重要的優(yōu)先列curricularstandard描述該資源與國家課程標準內(nèi)容框架的對code在實施教育教學的過程中，專門研究或討

表1

source1000該資源引用的訪問互“http://www.mauthor發(fā)布該資源的作者姓instructor該資源中的主講人的authorc該資源創(chuàng)建者的所在authorc_code該資源創(chuàng)建者的所在廣州市中小學的學校代碼（廣州市中小學學籍數(shù)據(jù)庫中各個單author_Area_code該資源作者所在區(qū)域authorp_code該資源作者所在省份該資源作者所在城市該資源所屬知識點標

JY/T0607—2017

vediopointvoicepointgrade_level_code

表1

該資源所屬學科課文該資源所屬學科課文該資源所屬學科課文該資源所屬學科課文該資源所屬學科課章

2005

clicksumce_type_code該資源所屬資源的類

該資源在技術上的數(shù)據(jù)類型，用于確定資格式分類代碼引用

30資源所需計算機存儲容量，該數(shù)據(jù)表明資該資源對應課程的出abstract該資源所在訪問鏈接

表1

H1zhmnbougzakokkenfrdeesrujaarH9qt42的計43Resource

的分44與關45relationship_description

表1

4.2

4880.1—2005選取，如表2所示。

A01

表3

表4

4.2.4專題教育資源分類代碼按照《中國圖書館圖書分類法（第五版）》類目簡表和

表5

ON01ON0101000～2

ON0102003～6

ON02ON020100ON020200ON020300ON020400ON020500ON020600ON03ON030100ON030200ON030300ON04ON040100ON040200ON040300ON05100ON05200ON05300SS11SS12SS13SS14SS15SS99

表5

表6

表7

RT01RT02RT03RT04RT05RT06RT07RT08SB0601SB0602SB0603SB0701SB0702SB0801SB0802SB0803

表7

表8

F001TXT(Text

F002RTF(Rich

Text

F003F004ODF(Open

Document

F005

Office

Document

F006PDF(Portable

Document

F007

Mobile

F008

Text

Markup

F009XML(Extensible

Markup

F010

(XML

Specification)F011

F012F013F015F016PostscriptF017F099F101

表8

表9

3)MIDI(Musical

Instrument

Audio)

AIFF(Audio

File

FLAC

Lossless

VOC(

Voice)S3M(Scream

Modules)

Music)CD(Compact

weighted

Interleave

Vector

ASF(Advanced

RM(Real

MP4(MPEG-4

F2

Pictures

Group)

Interleaved)RV(Real

RM(Real

Variable

Bitrate)

Video)ASF(Advanced

DIVX

Video）

表9

F214F215F216

Audio)F217RAM(Random

Access

F299圖形/圖像F301

Photographic

F302

F303F304

File

F305

F306F307F308F309F310EPS(Encapsulated

Post

F311

Graphics

F312

F313TGA(Tagged

F314F315SVG(Scalable

Vector

F316F317

Exchange

F318EPG(Electronic

Guide)F399其他圖形/圖像格式F401

Wave

Flash)F402

F403F499

表9

關聯(lián)類型分類代碼如表10所示。RS01Is

Part

Of

Part

RS02Is

Version

RS03Is

Format

Of

Format

RS04Is

Referenced

By

References

RS05Is

Replaced

By

Replaces

RS06Is

Required

Requires

String

StringString

5.1

所有接口統(tǒng)一按照HTTP

5.2

REST

HTTP

GET

POST

GET

URL

POST

URL

JSON

5.3

SUCCESS：成功FAILURE：失敗errorsList500500500timestampDate100100

request_id

100Date應用程序發(fā)出請求的客戶端時間，大平臺在接收到請求后，與當前服務端時間比較，如果在誤差范圍大于

10

min，將請String應用程序發(fā)出請求的唯一標識號，大平臺如果在誤差時間內(nèi)

message4000

5.3.3

5.3.4

access_token

檢查程序是否正確提供了access_token

access_token

app_key

檢查程序是否正確提供了

sign

sign_method

sign

sign_method

sign

sign_method

建議去掉

sign

參數(shù)采用不簽名方式，或者

timestamp

request_id

timestamp

request_id

11100～

產(chǎn)生此錯誤的原因是會話尚未得到授權或者已經(jīng)超時或

表示當前程序不是合法的應

試在發(fā)送請求前自行進行簽a)

運行應用程序的客戶端時間與接口服務端

b)

運行應用程序的客戶端與接口服務端之間a)

因為程序錯誤導致在多次調(diào)用中產(chǎn)生了相

b)

由于網(wǎng)絡原因請求被偶然重發(fā)，建議排查c)

請求被記錄并重放，建議排查網(wǎng)絡安全問12100～

碼,

第三方應用程序未獲得

13002會話未獲得授權調(diào)用指當前會話上下文無權限執(zhí)行所操作的對象超出當前

getXXX

可能用來判斷是否存在此對象，建議調(diào)用getXXX

14110～

getXXX

14210～創(chuàng)建對象時主鍵或具有創(chuàng)建對象時不允許空屬創(chuàng)建對象時部分屬性不14310～創(chuàng)建對象時遇到的其它更新對象時主鍵或具有更新對象時不允許空屬更新對象時部分屬性不14410～更新對象時遇到的其它14510～在刪除對象時遇到的其

19000～示接口服務端或客戶端程序出現(xiàn)不可預測的內(nèi)程序appSecretstring

Sign

按照一定順序規(guī)則拼接

ppKey、timestamp、randomNum、appSecre

后，再使用

sha1

加密算法，生

字符串順序規(guī)則：appSecret

randomNum

appKey

timestamp

sha1

5.4

access_token調(diào)用安全會話接口的login方法，以部門管理員賬戶創(chuàng)建會話獲取訪問令牌access_token，請求示

access_token

API

5.5

title

2000200special_subjectauthorcauthorc_codeauthor_area_codeauthorp_codeaccountnameidentity_numdivisiondivision_codeservice_orgextend_props4000creatorcreation_timeDatelast_modificatorlast_modification_timeDate

5.5.1

5.5.2

300grade_level_codeunit300300partclicksumsize30300abstract2000300

5.6

API

security/login.do URL

String500

String500

String500passwordString500org_codeString500access_tokenString500500

String500String500

500

5.6.2

security/logout.do

URL

5.6.3

security/get_current_user.do

String1000String100String200attributesTSUser500String500String500100List<DataSubjectInfo>50

data_subject/list.do URL

sha1

import

java.nio.charset.StandardCharsets;import

public

class

public

static

main(String[]

String

appSecret

String

randomNum

String

String

DigestSha

new

DigestSha();String

a.sha1(appSecret

randomNum

appSecret);System.out.println(sign);public

String

data)

MessageDigest

byte[]

dataByte

data.getBytes(StandardCharsets.UTF_8);messageDigest

MessageDigest.getInstance("SHA-1");messageDigest.update(dataByte);byte[]

messageDigest.digest();char

final

finalDataByte.length;final

char[]

out

new

char[len

len;

out[j++]

finalDataByte[i])

out[j++]

finalDataByte[i]];return

new

String(out);

catch

(Exception

throw

new

RuntimeException(e);

B.1

POST

application/json{"app_key":"APP_KEY","app_secret":"APP_SECRET","account":"ACCOUNT","password":"

{"success":true,"msg":"登陸成功！","obj":null,"attributes":{"access_token":"4028098184325ff2018432a1f22c0002","expires_in":86400}}

"ack_code":"SUCCESS","errors":[],"data":"account":"gz_byq","name":"白云區(qū)用戶","identity_num":"440111************","service_org":"123456789","creator":"admin","creation_time":"2012-5-22","last_modification_time":"2012-5-22"

B.1.3 POST

http://{API_ROOT}/security/logout.do?access_token=ACCESS_TOKEN

application/json{"success":true,"msg":"退出成功","obj":null,"attributes":{"ack_code":"SUCCESS"}}B.2

B.2.1 POST

applicat