Để thiết lập số lượng học viên hiển thị trên bục giảng, cần truyền các tham số, SID, safekey, timeStamp, course ID, class ID, number of students on stage, set the camera definition, and whether to enable dual-camera mode (i.e. enable the second camera). Giá trị tối đa được truyền cho tham số seatNum là số học sinh tối đa được hiển thị trên bục giảng của trường. Nếu bạn cần sửa đổi số lượng học sinh trên bục nhiều hơn số lượng tối đa của trường, vui lòng liên hệ với chúng tôi.
Lưu ý: Vui lòng truyền ít nhất 1 tham số seatNum hoặc isHd.
To modify the number of students on stage in a class, you need to provide SID, safekey, timeStamp, course ID, class ID, number of students on stage, set the camera definition, and whether to enable dual-camera mode (i.e. enable the second camera). Returns a successful description after execution. The maximum value that seatNum can modify is the maximum number of students on stage in the institution. If you need to modify the number of students on stage beyond the maximum number of students on stage in the institution, please contact the account manager.
Note : At least one of seatNum and isHd must be passed.
URL
https://api.eeo.cn/partner/api/course.api.php?action=modifyClassSeatNum
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 | — |
| seatNum | Bắt buộc | Số lượng học sinh tối đa được hiển thị trên bục giảng sẽ là số lượng mà trường đã đăng ký với ClassIn (số lượng tối đa hệ thống có thể thiết lập là 12) | Số lượng camera trên hiển thị trên bục giảng ( không bao gồm của giáo viên） | Ví dụ: Nếu cần thiết lập lớp 1v6 thì truyền tham số 6 |
| isHd | Không bắt buộc | 0= không HD, 1= HD, 2= Full HD, tất cả các giá trị khác ngoài 1 hoặc 2 sẽ mặc định được hiểu là 0 | Có bật chế độ HD hay không | cần truyền ít nhất 1 tham số SeatNum hoặc isHd để gọi API này |
Response data #
| Key | Định dạng | Phản hồi | Ý nghĩa |
|---|---|---|---|
| error_info | object | Returns an array of data | |
| └ errno | number | 1 | Mã lỗi |
| └ error | string | “program normal run” | Chi tiết lỗi |
Sample #
- HTTP request
POST /partner/api/course.api.php?action=modifyClassSeatNum 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&seatNum=6&isHd=2
- 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 "seatNum=6" \
-d "isHd=2"
"https://api.eeo.cn/partner/api/course.api.php?action=modifyClassSeatNum"
Response sample（The normal return json packet example） #
{
"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 |
| 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 |
| 147 | Không có thông tin về khóa học này |
| 149 | Khóa học này đã bị xóa |
| 153 | Khóa học đã hết hạn |
| 212 | Lớp học đã bị xóa |
| 259 | Số lượng học sinh trên bục giảng đã vượt quá giới hạn cho phép |
| 348 | Trong vòng 20 phút trước khi lớp học bắt đầu, không thể điều chỉnh số lượng học sinh trên bục giảng |
| 349 | Chỉnh sửa số lượng học sinh trên bục giảng thất bại |
| 367 | Điều chỉnh camera HD thất bại |
| 368 | Số lượng học sinh trên bục giảng được thiết lập cho lớp học này không hỗ trợ camera HD |
| 369 | Không hỗ trợ thao tác cho định dạng lớp học công khai |
| 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 |
| 808 | Không hỗ trợ thiết lập dual-camera cho lớp học này |
