Để chỉnh sửa thông tin lớp học, cần các truyền các tham số: SID, safekey, timeStamp, ID khóa học, tên lớp, thời gian lớp, tài khoản giáo viên, tên giáo viên, ID của Drive, ghi hình, phát trực tiếp, phát lại, trợ giảng, UID giáo viên, UID giáo viên phụ, v.v. SID, safeKey, timeStamp, courseId, classId là bắt buộc. Chỉnh sửa bất kỳ tham số nào trong ba tham số: ghi hình, phát trực tiếp, phát lại, thì hai tham số còn lại phải được điền, nếu không sẽ không có hiệu lực. Để thay đổi trạng thái ghi hình hiện trường, cần có ba tham số ghi hình đám mây của lớp, phát trực tiếp trên trang web và phát lại trên trang web. Để thay đổi số lượng người trên bục giảng, bạn cần gọi API Edit Students On The Stage In The Class.
Lưu ý:
- Tên lớp, thời gian lớp, tài nguyên trên đám mây và số lượng người trên sân khấu không thể thay đổi trong vòng 20 phút trước khi lớp bắt đầu.
- Nếu giáo viên đứng lớp bị thay đổi trong khi đang dạy, giáo viên sẽ bị thoát ra khỏi lớp.
- Nếu lớp học được thiết lập ghi hình (không thiết lập phát trực tiếp), more_data sẽ trả về địa chỉ trình phát trực tiếp của lớp, và địa chỉ pull stream sẽ trống.
- More_data trả về địa chỉ trình phát trực tiếp và địa chỉ pull stream của bài giảng nếu bài giảng được ghi hình và phát trực tiếp.
- Nếu bạn chỉnh sửa hoặc đặt các tham số khác mà không thay đổi bất kỳ tham số nào về ghi hình/phát trực tiếp/phát lại, more_data sẽ được trả về như khi tạo.
- Trợ giảng đã được thiết lập trước khi lớp học bắt đầu, và không thể thay thế hoặc xóa sau khi lớp học bắt đầu. Nếu không có giáo viên phụ được thiết lập sau lớp học, giáo viên phụ có thể được thêm vào.
- Các quy tắc tham số khác có sẵn trong Parameter Rules.
To modify the class information, you need to provide SID, safekey, timeStamp, course ID, class name, class start and end time, teacher account, teacher name, cloud disk directory ID, recording, live broadcast, playback, co-teachers, teaching mode, whether to automatically go on stage, teacher UID, co-teachers UID, web page live broadcast playback, allow non-logged in users to participate in live chat and like, etc. Among them, SID, safeKey, timeStamp, courseId, and classId are required items. Fill in the other parameters that need to be modified (modify any one of the three parameters of recording, live broadcast, and playback, and the other two parameters are required. Otherwise, it will not take effect). When modifying the recording site, the three parameters of recording, live broadcast, and playback are required. Return the success description after execution. To modify the number of people on stage, you need to call Edit Students On The Stage In The Class.
Notes：
- The course name, class time, cloud disk resources, number of people on stage, whether to automatically go on stage, and teaching mode cannot be modified within 20 minutes before the class starts.
- If the teacher of a section is changed during class, the teacher currently teaching the class will exit the classroom.
- If the course is set to be recorded (not live broadcast), more_data returns the address of the live broadcast player for the course, and the streaming address is empty.
- If the course is set up for recording or live broadcast, more_data returns the course live broadcast player address and streaming address.
- If you edit or set other parameters without changing any parameters of recording/live broadcast/revisit, more_data will be returned as it was when it was created.
- If co-teachers have been set up before the course starts, they can be replaced or deleted after the course starts; if co-teachers have not been set up before the course starts, they can be added after the course starts.
- For more parameter rules for editing a course, please refer to Parameter Rules.
URL
https://api.eeo.cn/partner/api/course.api.php?action=editCourseClass
HTTP Request Methods #
- POST
Coding format #
- UTF-8
Request data #
| Key | Bắt buộc | Yêu cầu thêm | Mô tả | Hướng dẫn |
|---|---|---|---|---|
| SID | Bắt buộc | — | ID của trường | Xem dữ liệu này tại Trang quản lý classin.com trong mục API |
| safeKey | Bắt buộc | Fixed 32-bit all lowercase characters | Khóa bảo mật xác thực trường học | safeKey=MD5(SECRET+timeStamp) |
| timeStamp | Bắt buộc | — | Theo Unix Epoch timestamp & có hiệu lực trong vòng 20 phút | 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 |
| courseId | Bắt buộc | — | ID Khóa học | — |
| classId | Bắt buộc | — | ID Lớp học | — |
| className | Không bắt buộc | — | Tên lớp | — |
| beginTime | Không bắt buộc | — | Thời gian bắt đầu lớp học | begin time value = Unix Epoch timeStamp |
| endTime | — | Nếu bạn điền beginTime thì bắt buộc điền endTime | Thời gian lớp học kết thúc | end time value = Unix Epoch timeStamp |
| teacherUid | Không bắt buộc | — | UID của giáo viên | UID hệ thống trả về khi đăng ký tài khoản thành công |
| folderId | Không bắt buộc | Mặc định là folderID của khóa học | — | — |
| record | Không bắt buộc | Mặc định là 0, các số khác không phải 1 sẽ được hiểu là 0 | Ghi hình (0=tắt, 1=bật) | — |
| recordScene | Không bắt buộc | Mặc định là 0, các số còn lại khác 1 sẽ được hiểu là 0 | Ghi hình camera của giáo viên 0=tắt; 1=mở | Nếu bạn cần phát trực tiếp hoặc phát lại, bạn phải chọn ghi hình bài giảng, nếu không bạn sẽ không thể mở phát trực tiếp hoặc phát lại |
| live | Không bắt buộc | Mặc định là 0, các số còn lại khác 1 sẽ được hiểu là 0 | Phát trực tiếp 0=tắt; 1=mở | — |
| replay | Không bắt buộc | Mặc định là 0, các số còn lại khác 1 sẽ được hiểu là 0 | Phát lại ghi hình lớp học 0=tắt; 1=mở | — |
| assistantUid | Không bắt buộc | Truyền ít nhất một assistantUid hoặc không truyền tham số này, vui lòng không truyền dữ liệu trống | UID của trợ giảng | UID hệ thống trả về khi đăng ký tài khoản thành công |
| assistantUids | Không bắt buộc | Truyền ít nhất một danh sách assistantUids dạng JSON và Int hoặc không truyền tham số này, vui lòng không truyền dữ liệu trống | Danh sách UID của nhiều trợ giảng | UID hệ thống trả về khi đăng ký tài khoản thành công |
| isAutoOnstage | Không bắt buộc | Mặc định là 0, các số còn lại khác 1 sẽ được hiểu là 0 | 0=tự động; 1=không tự động | Thiết lập cho học sinh tự động lên bục khi vào lớp, nếu không thì giáo viên phải thao tác đưa học sinh lên bục thủ công |
| classIntroduce | Không bắt buộc | Phần giới thiệu/ mô tả lớp có thể để trống, độ dài của phần này cho phép tối đa 1000 ký tự | — | — |
| watchByLogin | Không bắt buộc | Nếu không được truyền hoặc truyền không chính xác, sẽ không có thay đổi nào được thực hiện | Chỉ sau khi đăng nhập vào tài khoản ClassIn mới được phép xem, nếu không đăng nhập thì không thể xem. 0=Không mở, 1=Mở | Hai hoặc nhiều mục ghi hình khóa học, phát trực tiếp và phát lại không được bật, và tham số này sẽ không được sử dụng |
| allowUnloggedChat | Không bắt buộc | Nếu không được truyền hoặc truyền không chính xác, sẽ không có thay đổi nào được thực hiện | Người dùng không đăng nhập vẫn sẽ được tham gia bình luận và nhấn “like” khi xem livestream. 0=Không cho phép; 1=Cho phép | Nếu ghi hình lớp học và phát trực tiếp không được bật thì tham số này không cần truyền |
Response data #
Sample
- HTTP request
POST /partner/api/course.api.php?action=editCourseClass HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=2339736&safeKey=58ce17711abea665f40f67d550ce96fb&timeStamp=1493364941&courseId=490583&classId=1395039&className=chinese&beginTime=1493434330&endTime=1493444330&teacherAccount=18503160003&folderId=&record=1&live=1&replay=1
- Shell cURL analog request instruction.
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
-d "SID=1234567" \
-d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
-d "timeStamp=1484719085" \
-d "courseId=442447" \
-d "classId=23644" \
-d "className=测试课程" \
-d "beginTime=1484739085" \
-d "endTime=1484739085" \
-d "teacherUid=1001001" \
-d "folderId=1" \
-d "record=1" \
-d "live=1" \
-d "replay=1" \
-d "assistantUids=[1001002,1001003]" \
"https://api.eeo.cn/partner/api/course.api.php?action=editCourseClass"
Response sample（The normal return json packet example） #
{
"more_data": {
"live_url": "https://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164d",
"live_info": {
"RTMP": "rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
"HLS": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
"FLV": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd"
}
},
"error_info": {
"errno": 1,
"error": "程序正常执行"
}
}
Error Code Description
| Error Code | Description |
|---|---|
| 1 | Thành công |
| 100 | Parameters sai định dạng hoặc không hoàn chỉnh |
| 102 | Không có quyền thao tác (Xác thực bảo mật thất bại) |
| 104 | Thao tác thất bại |
| 114 | Lỗi server |
| 119 | Thời gian kết thúc lớp học phải trễ hơn thời gian bắt đầu |
| 120 | Thời gian lớp học bắt đầu phải cách thời điểm hiện tại ít nhất là 1 phút |
| 136 | Giáo viên này không thuộc danh sách giáo viên của trường. Vui lòng thêm giáo viên vào trường trước |
| 140 | Lớp học đang diễn ra không thể bị chỉnh sửa hay xóa |
| 142 | Lớp học không tồn tại trong khóa học |
| 143 | Không có thông tin về lớp học |
| 144 | Trường không có khóa học này |
| 145 | Lớp học này đã kết thúc và không thể xóa |
| 160 | Trường của bạn không có tệp tin/thư mục này trong Drive |
| 165 | Thời gian diễn ra lớp học tối thiểu là 15 phút và tối đa là 24 tiếng |
| 172 | Học sinh của khóa học không thể được chọn làm giáo viên đứng lớp khi tạo lớp học |
| 173 | Người dự thính của khóa học không thể được chọn làm giáo viên đứng lớp khi tạo lớp học |
| 212 | Lớp học đã bị xóa |
| 268 | Thời gian bắt đầu lớp học vượt quá thời hạn cho phép (Thời gian bắt đầu không được vượt quá 3 năm tính từ thời điểm hiện tại) |
| 282 | Lớp học đã được điều chỉnh thành công. Tham số ghi hình lớp học truyền không chính xác vì vậy ghi hình lớp học sẽ không được bật |
| 283 | Lớp học đã được điều chỉnh thành công, nhưng điều chỉnh ghi hình lớp học thất bại. Bạn chỉ có thể bật ghi hình trước khi lớp học diễn ra 20 phút |
| 284 | Lớp học đã được điều chỉnh thành công. Có vấn đề với hệ thống video vì vậy ghi hình lớp học sẽ không được bật |
| 318 | Trợ giảng không thuộc danh sách giáo viên của trường bạn |
| 319 | Học sinh của khóa học không thể được chọn làm trợ giảng của lớp |
| 320 | Người dự thính của khóa học không thể được chọn làm trợ giảng của lớp |
| 321 | Học sinh chuyển lớp không thể được chọn làm trợ giảng của lớp |
| 322 | Giáo viên đứng lớp không thể được chọn làm trợ giảng của lớp |
| 323 | Co-teachers failed to purchase lessons. |
| 324 | Không thể thêm giáo viên vào danh sách giáo viên trường |
| 325 | Học sinh chuyển lớp không thể được thêm làm giáo viên đứng lớp |
| 326 | Không thể thêm trợ giảng vào danh sách giáo viên trường |
| 327 | Xóa trợ giảng ra khỏi lớp thất bại |
| 328 | Trợ giảng trong lớp không thể được thêm vào lớp với vai trò giáo viên đứng lớp |
| 330 | Định dạng của tài khoản trợ giảng không chính xác (Mã lỗi này đã ngưng sử dụng từ tháng 4 2022) |
| 350 | Tên lớp, thời gian bắt đầu, tài liệu được cấp quyền từ Drive và số lượng học sinh trên bục giảng không thể bị điều chỉnh trong vòng 20 phút trước khi lớp học bắt đầu |
| 369 | Lớp học công khai không cho phép thao tác |
| 372 | Điều chỉnh chức năng tự động hiển thị học sinh lên bục thất bại |
| 385 | Lớp học đã kết thúc, không thể điều chỉnh thông tin giáo viên đứng lớp |
| 387 | Giáo viên đã bị vô hiệu hóa |
| 388 | Trợ giảng đã bị vô hiệu hóa |
| 400 | Dữ liệu yêu cầu không hợp lệ |
| 454 | Thời gian bắt đầu và kết thúc lớp học trùng với thời gian bảo trì của hệ thống |
| 466 | Lớp học được tạo từ LMS không thể chỉnh sửa thông qua API. Vui lòng truy cập ứng dụng ClassIn hoặc Trang quản lý để chỉnh sửa |
| 800 | Giáo viên đã bị cấm |
| 804 | Trợ giảng đã bị cấm |
| 825 | Lớp học đã được tạo thành công, nhưng phần thiết lập giới thiệu lớp học thất bại |
| 880 | Không thể điều chỉnh chế độ giảng dạy |
| 884 | Tài khoản của GV đã bị xóa |
| 885 | Tài khoản của trợ giảng đã bị xóa |
| 21316 | Dữ liệu trợ giảng bị trùng lặp |
| 21317 | Số lượng trợ giảng đã vượt giới hạn |
