Để chỉnh sửa khóa học cần truyền các tham số SID, safeKey, timeStamp, ID khóa học. Các tham số còn lại là tùy chọn và bạn chỉ cần truyền trường bạn muốn chỉnh sửa.
Ghi chú:
- Có thể điều chỉnh Giáo viên chủ nhiệm (GVCN) của khóa học. Giáo viên chủ nhiệm có khả năng chỉnh sửa khóa học trong ứng dụng ClassIn, chẳng hạn như tạo/chỉnh sửa/xóa lớp học và học sinh. Các thao tác của giáo viên chủ nhiệm trong ứng dụng ClassIn sẽ không được đồng bộ hóa với hệ thống dữ liệu của trường. Ví dụ, giáo viên chủ nhiệm tạo một lớp học mới trong khóa học trên ứng dụng ClassIn. Dữ liệu của lớp học mới thêm sẽ không được đồng bộ hóa với hệ thống của trường.
- Không thể xóa giáo viên chủ nhiệm sau khi đã đặt. API chỉ hỗ trợ thay đổi giáo viên chủ nhiệm. Khi truyền giá trị trống cho mainTeacherUid, điều đó đồng nghĩa với việc không có giá trị nào được truyền và dữ liệu không bị thay đổi.
To edit the course, SID, safeKey, timeStamp, course ID are required. The rest parameters are optional and you only need to pass the field you want to edit. The request will return the instruction for you to refer to.
Notes:
- You can set a headteacher, also named Course Advisor/Main Teacher in the School Dashboard, when creating the course. The headteacher can edit the course in the ClassIn app, such as create/edit/delete lessons and course students in the IM group. The operation in the ClassIn app by headteachers will not be synchronized to your school’s system. For example, the headteacher created a new lesson in the IM group. The data of the newly added lesson will not be synchronized to your system.
- You cannot remove the headteacher once set. The API only supports to change the headteacher. When passing an empty value for mainTeacherUid, it means you did not pass a value and did not modify the parameter.
URL
https://api.eeo.cn/partner/api/course.api.php?action=editCourse
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 | Unix Epoch timeStamp is the number of seconds passed by 00:00 (world standard time) on January 1, 1970 |
| courseId | Bắt buộc | — | Course ID | — |
| folderId | Không bắt buộc | — | ID thư mục mới | — |
| courseName | Không bắt buộc | — | Tên mới của khóa học | — |
| expiryTime | Không bắt buộc | Nếu tham số này trống, hệ thống sẽ hiểu là không có điều chỉnh. Nếu truyền 0 – thời hạn khóa học sẽ thiết lập thành vô hạn không kết thúc; Nếu truyền thời hạn cụ thể thì thời hạn tối đa là 1 năm tính từ thời điểm hiện tại | Expiration time | Unix Epoch timeStamp |
| mainTeacherUid | Không bắt buộc | Nếu không có tham số được truyền hệ thống sẽ hiểu là không có thay đổi | UID của tài khoản giáo viên | UID hệ thống trả về khi đăng ký tài khoản thành công |
| subjectId | Không bắt buộc | Nếu tham số này không được truyền hoặc để trống thì hệ thống sẽ hiểu là 0 | Course subject | 1: Chinese; 2: Maths; 3: English; 4: Physics; 5: Chemistry; 6: Biology; 7: Politics; 8: History; 9: Geography; 10: Ideological and Moral Education; 11: Music; 12: PE; 13: Arts; 14: General Technology; 15: IT; 16: Science; 99: Others |
| stamp | Không bắt buộc | 1=thêm，2=không thêm, mặc định là 1 | Sau khi thay đổi GVCN thì bạn có muốn thêm GVCN vào danh sách GV của khóa học hay không | — |
| Filedata | Không bắt buộc | Binary stream | Tải lên ảnh bìa của khóa học | — |
| courseIntroduce | Không bắt buộc | Phần giới thiệu/ mô tả khóa học có thể để trống, độ dài của phần này cho phép tối đa 400 ký tự | Course introduction | — |
| classroomSettingId | Không bắt buộc | Mặc định là 0 | ID cài đặt lớp học | Tại giao diện Trang quản lý của ClassIn classin.com, trong phần Cài đặt — > Cài đặt lớp học, bạn sẽ thấy các bộ Cài đặt lớp học đã được thiết lập sẵn kèm với ID. Bộ “Cài đặt lớp học” được chọn sẽ áp dụng cho tất cả các lớp thuộc khóa học. “Cài đặt lớp học” bao gồm: nền lớp học, bật/tắt các tính năng trong lớp học (Drive, Danh sách lớp, Valy công cụ,…), các thiết lập lớp học (đếm ngược thời gian ghi hình tự động, bật/tắt phần chat lớp,…) |
Response data #
| key | Type | Sample value | meaning |
|---|---|---|---|
| error_info | object | Return message object | |
| └ errno | number | 1 | Error code |
| └ error | string | “Program normal execution” | Error list |
Sample #
- HTTP request
POST /partner/api/course.api.php?action=editCourse HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=2339736&safeKey=f834fff59eb3bc8a2ff26a3cb59155f0&timeStamp=1492792399&courseId=352861&folderId=22419&courseName=Today+is+a+good+day&expiryTime=&mainTeacherUid=1001001&Filedata=@~/photo.jpg&courseIntroduce=ClassIn,真正专业的在线教室&classroomSettingId=235
- 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=352861" \
-d "folderId=22419" \
-d "courseName=Today is a good day" \
-d "expiryTime=1484811085" \
-d "mainTeacherUid=1001001" \
-d "stamp=2" \
-d "Filedata=@~/photo.jpg" \
-d "courseIntroduce=ClassIn,真正专业的在线教室" \
-d "classroomSettingId=235" \
"https://api.eeo.cn/partner/api/course.api.php?action=editCourse"
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) |
| 103 | Tải lên hình ảnh thất bại |
| 104 | Thao tác thất bại |
| 114 | Lỗi server |
| 144 | Không có khóa học này trong trường |
| 147 | Không có thông tin về khóa học này |
| 149 | Khóa học này đã bị xóa |
| 151 | Thời gian kết thúc khóa học tối thiểu là 1 ngày sau |
| 152 | Thời hạn kết thúc khóa học không thể sớm hơn thời gian kết thúc của lớp học cuối cùng |
| 153 | Khóa học đã kết thúc |
| 154 | Thời gian kết thúc khóa học tối đa là 1 năm |
| 160 | Không có tệp/thư mục này trong Drive trường |
| 260 | Thêm GVCN không thành công |
| 310 | GVCN mới được thêm không tồn tại |
| 311 | Học sinh của khóa học không thể được thêm làm GVCN |
| 312 | Người dự thính của khóa học không thể được thêm làm GVCN |
| 314 | Không thể thay thế GVCN cũ vì giáo viên vẫn còn lớp chưa hoàn thành |
| 331 | Định dạng tài khoản của GVCN không hợp lệ |
| 334 | GVCN vừa được thêm không thuộc danh sách giáo viên của trường |
| 369 | Lớp học công khai không hỗ trợ điều chỉnh |
| 371 | “Cài đặt lớp học” không tồn tại |
| 373 | “Cài đặt lớp học” không thuộc trường này |
| 389 | GVCN này đã bị vô hiệu hóa |
| 400 | Dữ liệu yêu cầu không hợp lệ |
| 805 | Tài khoản của GVCN này đã bị cấm |
| 883 | GVCN này đã xóa tài khoản |
