Chức năng: Tạo mô hình lớp học liên kết trực tuyến. Thông qua việc truyền ID lớp học và ID của buổi học chính cùng ID của các lớp học cần liên kết để hệ thống thực hiện thao tác tạo ra những buổi học phụ trong các lớp học được liên kết
Mô tả:
- Buổi học chính và buổi học phụ không thể nằm trong cùng một lớp học. Các buổi học phụ cũng không thể nằm trong cùng một lớp học với nhau.
- Trả về thông tin về việc mỗi buổi học phụ có được tạo thành công hay không, bao gồm ID lớp học, ID buổi học phụ và tên buổi học phụ được liên kết.
- Các buổi học phụ sẽ có cùng thông tin giáo viên đứng lớp & thời gian học của buổi học chính.
- Các buổi học phụ sẽ chỉ có thể sử dụng bộ tài liệu được cấp quyền cho lớp học tương ứng mà buổi học đó thuộc về.
- subClassJson tối đa là 100 và một buổi học chính có thể được liên kết với tối đa 100 buổi học phụ.
- Nếu cần thiết lập phát trực tiếp hoặc phát lại ghi hình lớp học cho một buổi học phụ, cần truyền useCoMainRecord, recordState, recordType, liveState và openState cùng lúc; nếu không, hệ thống sẽ báo cáo lỗi tham số.
Interface function: Support users to pass the main class ID and sub-class information (in batches), complete the creation of sub-classes and bind the main and sub-classes
Interface description:
- Returns information on whether each sub-class is created successfully or not, including the course ID, sub-class ID, and sub-class name of the sub-class
- Sub-classes do not need to pass the main teacher and time, and inherit the main teacher and time of the main class
- Sub-classes inherit the cloud disk resources of the course to which they belong
- The maximum number of subCalssJson is 100, limiting a single main class to bind up to 100 sub-classes
- If the sub-class needs to set up a live playback of the recorded class, useCoMainRecord, recordState, recordType, liveState, and openState must be passed at the same time, otherwise a parameter error will be reported
URL
https://api.eeo.cn/lms/onlineDoubleTeacher/addClass
HTTP Request Methods
- POST
Encoding format
- UTF-8
Request parameters
Header parameters
| Key | Bắt buộc | Định dạng | Mô tả |
|---|---|---|---|
| X-EEO-SIGN | Bắt buộc | string | Signature; tham khảo cách tạo tại đây |
| X-EEO-UID | Bắt buộc | string | SID (Xem dữ liệu này tại Trang quản lý classin.com trong mục API) |
| X-EEO-TS | Bắt buộc | string | Timestamp (Thời gian UNIX Epoch là số giây đã trôi qua kể từ 00:00:00 (giờ chuẩn quốc tế) vào ngày 1 tháng 1 năm 1970) |
Body parameters
| Key | Bắt buộc | Định dạng | Mô tả | Hướng dẫn |
|---|---|---|---|---|
| mainCourseId | Bắt buộc | integer | ID của lớp học chính | |
| mainClassId | Bắt buộc | integer | ID của buổi học chính | |
| subCalssJson | Bắt buộc | array | Danh sách các lớp học phụ cần liên kết | Tối đa 100 subCalssJson |
| └ courseId | Bắt buộc | integer | ID lớp học của những lớp học phụ cần liên kết | |
| └ className | Bắt buộc | string | Tên buổi học | Tối đa 50 ký tự |
| └ assistantUids | Không bắt buộc | array | ID của trợ giảng trong buổi học phụ | Nếu không truyền mặc định buổi học đó không có trợ giảng |
| └ cameraHide | Không bắt buộc | integer | Thiết lập ẩn/hiện bục giảng | 0 = Không (hiển thị bục giảng), 1 = Có (Ẩn bục giảng). Mặc định 0; nếu không truyền thì tham số sẽ theo mặc định; nếu tham số truyền sai thì sẽ hiện báo lỗiparameter error; khicameraHide = 1, isAutoOnstage sẽ luôn là 0 |
| └ isAutoOnstage | Không bắt buộc | integer | Thiết lập cho thành viên lớp tự động hiển thị trên bục khi vừa vào lớp | 1 = Không, 2 = Có. Mặc định là 1; nếu không truyền |
| └ seatNum | Không bắt buộc | integer | Số lượng camera hiển thị trên bục giảng | Bao gồm cả camera của GV; Ví dụ: truyền 1 nghĩa là chọn chế độ 1v0 (chỉ hiển thị 1 camera của GV); nếu tham số này bỏ trống thì hệ thống sẽ mặc định để là 7 (tương đương chế độ 1v6). Nếu gói dịch vụ của trường có thiết lập số lượng camera trên bục thấp hơn thì hệ thống sẽ lấy dữ liệu dựa theo gói dịch vụ của trường |
| └ isHd | Không bắt buộc | integer | Chất lượng hiển thị của camera | 0 = SD, 1 = HD, 2 = Full HD. Mặc định là 0 khi tham số này không được truyền; Nếu tham số được truyền khác với các giá trị trên, hệ thống sẽ trả lỗi parameter error. Hiện tại, chỉ hỗ trợ chất lượng HD và FullHD cho chế độ 1v1 hoặc 1v6. |
| └ isDc | Không bắt buộc | integer | Buổi học có sử dụng chế độ dual-camera hay không | 0 = Không cho phép, 3 = Cho phép. Mặc định là 0 khi tham số này không được truyền; Nếu tham số được truyền khác với các giá trị trên, hệ thống sẽ trả lỗi parameter error; Nếu isDc là 3 và số camera trên bục được thiết lập không phải chế độ 1v1 thì hệ thống sẽ trả lỗi this setting does not support dual-camera; Khi isDC = 3 và vàseatNum = 2, thì isHd sẽ mặc định là 2 (hệ thống sẽ bỏ qua giá trị được truyền ở trường isHd) |
| └ useCoMainRecord | Không bắt buộc | integer | Thiết lập sử dụng dữ liệu ghi hình buổi học chính cho các buổi phụ. 1= Sử dụng, 0=Không sử dụng | Khi useCoMainRecord là 1, dữ liệu ghi hình của các buổi học phụ sẽ được bỏ qua. Các buổi học này sẽ lấy cùng dữ liệu ghi hình với buổi học chính |
| └ recordState | Không bắt buộc | integer | Thiết lập ghi hình buổi học 0=Tắt, 1=Bật | Mặc định là 0, nếu tham số này không được truyền hoặc bỏ trống |
| └ recordType | Không bắt buộc | integer | Thiết lập chế độ ghi hình buổi học | 0 = Ghi hình lớp học, 1 = Ghi hình camera giáo viên, 2 = Ghi hình lớp học và camera giáo viên. Mặc định là 0 khi tham số này không được truyền; Nếu tham số được truyền khác với các giá trị trên, hệ thống sẽ trả lỗi parameter error |
| └ liveState | Không bắt buộc | integer | Thiết lập chế độ livestream | 0 = Tắt, 1 = Bật livestream. Mặc định là 0 khi tham số này được truyền trống; Nếu tham số được truyền có giá trị khác với các giá trị trên, hệ thống sẽ trả lỗi parameter error. Nếu trường này truyền tham số là 1 thì recordState bắt buộc truyền 1 |
| └ openState | Không bắt buộc | integer | Thiết lập chế độ phát lại ghi hình | 0 = Tắt, 1 = Bật phát lại ghi hình. Mặc định là 0 khi tham số này được truyền trống; Nếu tham số được truyền có giá trị khác với các giá trị trên, hệ thống sẽ trả lỗi parameter error. Nếu trường này truyền tham số là 1 thì recordState bắt buộc truyền 1 |
| └ uniqueIdentity | Không bắt buộc | string | Tối đa 32 ký tự |
Response data
| Key | Định dạng | Phản hồi | Ý nghĩa |
|---|---|---|---|
| code | integer | 1 | Mã lỗi |
| msg | string | “Program executes normally” | |
| data | object | ||
| └ mainClassId | integer | 4157055 | ID buổi học chính |
| └ mainCourseId | integer | 2337435 | ID lớp học chính |
| └ subClassData | array | [{Sub-class data}] | Thông tin các buổi học phụ |
Sub-class data
| Key | Định dạng | Phản hồi | Ý nghĩa |
|---|---|---|---|
| classId | integer | 4157912 | ID buổi học |
| courseId | integer | 2337436 | ID lớp học |
| className | string | “2337436-subClassName” | Tên buổi học |
| liveUrl | string | “https://www.eeo.cn/live.php?lessonKey=7a32f568ed7b725c“ | URL link phát lại ghi hình |
| liveInfo | object | {} | Thông tin livestream |
| └ FLV | string | “https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2.flv?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd“ | Địa chỉ FLV livestream |
| └ HLS | string | “https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2.m3u8?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd“ | Địa chỉ HLS livestream |
| └ RTMP | string | “rtmp://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd” | Địa chỉ RTMP livestream |
| uniqueIdentity | string | “” | |
| code | integer | 1 | Mã lỗi |
| msg | string | “Program is running normally” |
Example
- HTTP request
POST /lms/onlineDoubleTeacher/addClass HTTP/1.1
Host: root_url
X-EEO-SIGN: 43a81ec4d7b213d20912826d95ba381a
X-EEO-UID: 2669800 X-EEO-TS: 1732270810 Content-Type: application/json Content-Length: 539 { "mainCourseId": 2337435, "mainClassId": 4157055, "subClassJson": [ { "courseId": 2337436, "className": "2337436-subClassName", "seatNum": 7, "isHd": 2, "isDc": 0, "cameraHide": 0, "isAutoOnstage": 1, "liveState": 1, "openState": 1, "recordState": 1, "recordType": 0, "useCoMainRecord": 0 }, { "courseId": 2337437,
"className": "2337437-subClassName",
"assistantUids": [
1445886
],
"seatNum": 7,
"isHd": 1,
"isDc": 0,
"cameraHide": 0,
"isAutoOnstage": 1,
"liveState": 1,
"openState": 1,
"recordState": 1,
"recordType": 1,
"useCoMainRecord": 1
}
]
}
- Shell cURL simulation request instruction
curl -X POST \
-H 'Host: root_url' \
-H 'X-EEO-SIGN: 43a81ec4d7b213d20912826d95ba381a' \
-H 'X-EEO-UID: 2669800' \
-H 'X-EEO-TS: 1732270810' \
-H 'Content-Type: application/json' \
-d '{"mainCourseId": 2337435, "mainClassId": 4157055, "subClassJson": [{"courseId": 2337436, "className": "2337436-subClassName", "seatNum": 7, "isHd": 2, "isDc": 0, "cameraHide": 0, "isAutoOnstage": 1, "liveState": 1, "openState": 1, "recordState": 1, "recordType": 0, "useCoMainRecord": 0}, {"courseId": 2337437, "className": "2337437-subClassName", "assistantUids": [1445886], "seatNum": 7, "isHd": 1, "isDc": 0, "cameraHide": 0, "isAutoOnstage": 1, "liveState": 1, "openState": 1, "recordState": 1, "recordType": 1, "useCoMainRecord": 1}]}' \
'https://root_url/lms/onlineDoubleTeacher/addClass'
Response example (example of json data packet returned)
{
"code": 1,
"msg": "程序正常执行",
"data": {
"mainClassId": 4157055,
"mainCourseId": 2337435,
"subClassData": [
{
"classId": 4157912,
"courseId": 2337436,
"className": "2337436-subClassName",
"liveUrl": "https://www.eeo.cn/live.php?lessonKey=7a32f568ed7b725c",
"liveInfo": {
"FLV": "https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2.flv?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd",
"HLS": "https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2.m3u8?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd",
"RTMP": "rtmp://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1ec9c2d2?txSecret=57bd3671122a2e22a2fe306e8af2a0dd&txTime=7d8d37cd"
},
"uniqueIdentity": "",
"code": 1,
"msg": "程序正常执行"
},
{
"classId": 4157913,
"courseId": 2337437,
"className": "2337437-subClassName",
"liveUrl": "",
"liveInfo": {},
"uniqueIdentity": "",
"code": 1,
"msg": "程序正常执行"
}
]
}
}
