Chỉnh sửa khóa học

Mục lục

Để 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ú:
 
  1. 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.
  2. 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:

  1. 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.
  2. 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 Định dạng Phản hồi Ý nghĩa
error_info object   Return message object
└ errno number 1 Mã lỗi
└ error string “Program normal execution” Chi tiết lỗi

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