Chức năng: Sửa đổi thông tin như giáo viên chính, trợ giảng và thời gian diễn ra buổi học.
Mô tả:
- Giao diện này chỉ hỗ trợ sửa đổi các buổi học được tạo bởi tính năng Lớp học liên kết (Dual Lesson).
- Khi giáo viên và thời gian của buổi học chính được thay đổi, các buổi học phụ cũng sẽ được thay đổi đồng thời.
- Các buổi học phụ không cho phép thay đổi giáo viên chính hoặc thời gian diễn ra buổi học (các thông tin này sẽ lấy từ buổi học chính).
- Giao diện này chỉ hỗ trợ truyền các tham số cần sửa đổi; có thể truyền một hoặc nhiều tham số. Nếu không có tham số nào được truyền, lỗi “Tham số chưa đầy đủ” sẽ được báo cáo.
- Nếu bạn cần sửa đổi thiết lập ghi hình buổi học của một buổi phụ, bạn phải truyền đồng thời useCoMainRecord, recordState, recordType, liveState và openState; nếu không sẽ nhận phản hồi lỗi tham số.
Interface function: Modify the main teacher, teaching assistant, time and other information of the online double teacher main classroom and sub-classrooms
Interface description:
- This interface only supports modifying the main and sub-classrooms of online double teacher classrooms
- When the main teacher and time are modified in the main classroom, the sub-classrooms will be modified synchronously
- The main teacher and time are not allowed to be modified in the sub-classrooms
- This interface supports only passing the parameters that need to be modified, one or more can be passed; if none are passed, [Incomplete parameters] error will be reported
- If the sub-class needs to modify the live playback of the recorded lessons, 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/editClass
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 |
|---|---|---|---|---|
| courseId | Bắt buộc | integer | ID của lớp | |
| classId | Bắt buộc | integer | ID của buổi học | |
| className | Không bắt buộc | string | Tên buổi học | Độ dài không được vượt quá 50 ký tự |
| teacherUid | Không bắt buộc | integer | UID của giáo viên chính (chỉ áp dụng cho buổi học chính) | Tham số này chỉ hỗ trợ thay đổi cho buổi học chính. Nếu cần thay đổi trợ giảng trong buổi học phụ, vui lòng sử dụng tham số assistantUids |
| startTime | Không bắt buộc | integer | Thời gian buổi học bắt đầu (chỉ áp dụng cho buổi học chính) | 1. Sử dụng Unix Epoch timestamp (giây); 2. Chỉ có thể chỉnh sửa buổi học chính, buổi học phụ không thể chỉnh sửa tham số này vì thời gian của buổi học phụ sẽ được lấy theo buổi học chính. Khi thời gian của buổi học chính thay đổi thì buổi học phụ cũng thay đổi đồng thời; 3. Có thể thiết lập bất kỳ mốc thời gian nào trong vòng 2 năm tính từ thời điểm hiện tại; |
| endTime | Không bắt buộc | integer | Thời gian buổi học kết thúc (chỉ áp dụng cho buổi học chính) | 1. Sử dụng Unix Epoch timestamp (giây); 2. Chỉ có thể chỉnh sửa buổi học chính, buổi học phụ không thể chỉnh sửa tham số này vì thời gian của buổi học phụ sẽ được lấy theo buổi học chính. Khi thời gian của buổi học chính thay đổi thì buổi học phụ cũng thay đổi đồng thời; |
| assistantUids | Không bắt buộc | array | Danh sách UID của trợ giảng | Không có trợ giảng hoặc không chỉnh sửa thông tin này thì không cần truyền |
| 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ỗi parameter error |
| 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ó |
| 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; |
| 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 |
| 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 |
| 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 | Không chỉnh sửa thông tin này thì không cần truyền |
| 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. |
| replayState | Không bắt buộc | integer | Thiết lập phát lại ghi hình trên web | 0 = Tắt, 1 = Bật cho phép phát lại ghi hình trên web |
Response parameters
| Key | Định dạng | Phản hồi | Ý nghĩa |
|---|---|---|---|
| code | integer | 1 | Mã lỗi |
| msg | string | “Program is running normally” | |
| data | array | Class data |
Class data
| Key | Định dạng | Phản hồi | Ý nghĩa |
|---|---|---|---|
| isMainClass | integer | 1 | Xác định xem đây có phải là buổi học chính hay không, 1=phải, 0=không |
| classId | integer | 4157912 | ID của 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 |
| code | integer | 1 | Mã lỗi |
| msg | string | “Program is running normally” |
Example
- HTTP request
POST /lms/onlineDoubleTeacher/editClass HTTP/1.1
Host: root_url
X-EEO-SIGN: 284dab41f025cd7ecd2920575defb189
X-EEO-UID: 2669800
X-EEO-TS: 1732271416
Content-Type: application/json
Content-Length: 357
{
"courseId": 2337435,
"classId": 4157055,
"className": "Edit main classroom name and time",
"startTime": 1732935660,
"endTime": 1732950000,
"teacherUid": 2669800,
"assistantUids": [
1340566
],
"seatNum": 8,
"isHd": 0,
"cameraHide": 0,
"isAutoOnstage": 1,
"liveState": 1,
"openState": 1,
"recordState": 1,
"recordType": 1
}
- Shell cURL Simulate request instructions
curl -X POST \
-H 'Host: root_url' \
-H 'X-EEO-SIGN: 284dab41f025cd7ecd2920575defb189' \
-H 'X-EEO-UID: 2669800' \
-H 'X-EEO-TS: 1732271416' \
-H 'Content-Type: application/json' \
-d '{"courseId": 2337435, "classId": 4157055, "className": "Edit main classroom name and time", "startTime": 1732935660, "endTime": 1732950000, "teacherUid": 2669800, "assistantUids": [1340566], "seatNum": 8, "isHd": 0, "cameraHide": 0, "isAutoOnstage": 1, "liveState": 1, "openState": 1, "recordState": 1, "recordType": 1}' \
'https://root_url/lms/onlineDoubleTeacher/editClass'
Response example (example of json data packet returned )
{
"code": 1,
"msg": "程序正常执行",
"data": [
{
"isMainClass": 1,
"classId": 4157055,
"liveUrl": "https://www.eeo.cn/live.php?lessonKey=84b978349296b821",
"liveInfo": {
"FLV": "https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1f9d918c.flv?txSecret=4cb4e8a5aae291d6df409e97fd6dae8c&txTime=7d8d37cd",
"HLS": "https://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1f9d918c.m3u8?txSecret=4cb4e8a5aae291d6df409e97fd6dae8c&txTime=7d8d37cd",
"RTMP": "rtmp://liveplay.eeo.cn/eeolive/576f5a8ccf87-18329106c1f9d918c?txSecret=4cb4e8a5aae291d6df409e97fd6dae8c&txTime=7d8d37cd"
},
"code": 1,
"msg": "程序正常执行"
},
{
"isMainClass": 0,
"classId": 4157912,
"liveUrl": "",
"liveInfo": {},
"code": 1,
"msg": "程序正常执行"
},
{
"isMainClass": 0,
"classId": 4157913,
"liveUrl": "",
"liveInfo": {},
"code": 1,
"msg": "程序正常执行"
}
]
}
Error code description
