Tạo phân nhóm học tập cho khóa học

Mục lục

English below

API dùng để tạo phân nhóm học tập cho Khóa học, thiết lập số thành viên trong nhóm và thay đổi thành viên giữa các nhóm. 

To create a group plan for the course, you can set the group numbers and switch members to each group. The group plan will be applied to the classroom grouping tool inside the virtual classroom.

URL

https://root_url/partner/api/course.api.php?action=addCourseGroup

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  — course ID
groupList Bắt buộc json string — [ [{ “studentUid”: 1000152,”isLeader”: 1}, {“studentUid”: 1000109,”isLeader”: 0}],[{“studentUid”: 1000101,”isLeader”: 1}, {“studentUid”: 1000100,”isLeader”: 0}]]
groupName Bắt buộc Cho phép hiển thị tối đa 20 ký tự Tên của phân nhóm —

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
data number 147667 group ID

Sample

  • HTTP Request
POST /partner/api/course.api.php?action=addCourseGroup HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache


SID=1234567&safeKey=5458edceccc78c6698de624e94364285&timeStamp=1493026245&courseId=176465&groupName=课程分组&groupList= [[{"studentUid": 1000152, "isLeader": 1 }, { "studentUid": 1000109, "isLeader": 0}],[{"studentUid": 1000101,"isLeader": 1}, {"studentUid": 1000100,"isLeader": 0}]]
  • Shell cURL analog request instruction
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
       -d "SID=123456" \
       -d "safeKey=b8fa5232411a0870ccd1f51c2146fdc9" \
       -d "timeStamp=1637133326" \
       -d "courseId=176465" \
       -d "groupName=课程分组" \
       -d 'groupList= [[{"studentUid": 1000152, "isLeader": 1 }, { "studentUid": 1000109, "isLeader": 0}],[{"studentUid": 1000101,"isLeader": 1}, {"studentUid": 1000100,"isLeader": 0}]]'\
       "https://root_url/partner/api/course.api.php?action=addCourseGroup"

Response Sample（The normal return json packet example）

{
"error_info": {
    "errno": 1,
    "error": "程序正常执行"
},
"data": 147667 //groupId
}

Notes

Description of groupList parameter
[
[{
"studentUid": 1000152,
"isLeader": 1

},
{"studentUid": 1000109,
"isLeader": 0

}],
[{
"studentUid": 1000101,
"isLeader": 1

},
{"studentUid": 1000100,
"isLeader": 0

}]
]    
1. Paramter of studentUid and isLeader are required, there should be a leader for each team.   (isLeader indicates the team leader.  1=Yes 0=No)    
2. Team members can not be duplicated

Error Code description

Error Code Mô tả
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 không thành công (lỗi không xác định)
890 Thiết lập phân nhóm thất bại
892 Thao tác không thành công vì đã tồn tại phân nhóm
895 Thao tác không thành công, UID trưởng nhóm sai
896 Thao tác thất bại, học sinh không tồn tại trong trường
897 Thao tác thất bại. Tất cả học sinh đều chưa được thêm vào khóa học
898 Thao tác thành công. Một số studentUID chưa chính xác