Để thêm học sinh vào nhiều lớp học của một khóa học, cần truyền các tham số SID, safeKey, timeStamp, courseID, studentUID, danh sách lớp học cần thêm (classID).
Lưu ý: không nên thêm cùng lúc quá 100 lớp
To add a student to multiple lessons in the course, SID, safeKey, timeStamp, course ID, student UID, class array(class ID) are required. The data returned includes the description of execution for each lesson.
Note: It is recommended that no more than 100 lessons be added at one time.
URL
https://api.eeo.cn/partner/api/course.api.php?action=addCourseClassStudent
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 | — |
| studentUid | Bắt buộc | Truyền tham số studentAccount hoặc studentUid. Nếu studentUid và studentAccount được gửi đồng thời, thì studentUid sẽ được ưu tiên | — | UID hệ thống trả về khi đăng ký tài khoản thành công |
| classJson | Bắt buộc | — | Danh sách ID của các lớp cần thêm học sinh vào | — |
| └ ID of class 1 | Bắt buộc | — | ClassID | — |
| └ ID of class 2 | Không bắt buộc | — | ClassID | — |
| └ ······ | Không bắt buộc | — | ClassID | — |
Response Data #
| Key | Định dạng | Phản hồi | Ý nghĩa |
|---|---|---|---|
| data | array | [] | Returns an array of Data information |
| └ data return information 1 | object | Return message object | |
| └ errno | number | 1 | Error code |
| └ error | string | “Normal execution” | Error list |
| └ data return message 2 | object | return message object | |
| └ errno | number | 1 | Error code |
| └ error | string | “Normal execution” | Error list |
| └ ······ | object | return message object | |
| └ errno | number | ··· | Error code |
| └ error | string | ··· | Error list |
| error_info | object | return message object | |
| └ errno | number | 1 | Error code |
| └ error | string | “Normal execution” | Error list |
Sample #
- HTTP Request
POST /partner/api/course.api.php?action=addCourseClassStudent HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=2339736&safeKey=dcbc0d041c043f3a4decabe6d24e61dd&timeStamp=1493712683&courseId=490583&studentUid=1001001&studentName=Jeck&classJson=[1395045,1395044,1395043]
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=123456" \ -d "studentUid=1001001" \ -d "studentName=小红" \ -d "classJson=[1212131,1212123]" \ "https://api.eeo.cn/partner/api/course.api.php?action=addCourseClassStudent"
Response sample（The normal return json packet example） #
{
"data": [
{
"errno": 1,
"error": "程序正常执行"
}
],
"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) |
| 113 | Số điện thoại chưa được đăng ký tài khoản |
| 114 | Lỗi server |
| 129 | Giáo viên của khóa học không thể được thiết lập làm học sinh |
| 134 | Số điện thoại không hợp lệ |
| 142 | Không có thông tin lớp học trong khóa học này |
| 144 | Không có khóa học này trong trường |
| 145 | Lớp học đã kết thúc |
| 149 | Khóa học đã bị xóa |
| 153 | Khóa học đã kết thúc và không thể được chỉnh sửa |
| 155 | Danh sách học sinh không được để trống |
| 157 | Số lượng học sinh trong lớp học đã vượt quá giới hạn |
| 158 | Thêm học sinh vào lớp học thất bại |
| 164 | Tài khoản này đã tồn tại trong khóa học với vai trò người dự thính |
| 166 | Học sinh đã tồn tại trong lớp học |
| 212 | Lớp học đã bị xóa |
| 228 | Không có học sinh này trong trường học |
| 332 | Giáo viên đứng lớp và trợ giảng không thể được thiết lập làm học sinh của lớp học |
| 333 | Giáo viên chủ nhiệm không thể được thiết lập làm học sinh của lớp học |
| 369 | Lớp học công khai không hỗ trợ điều chỉnh |
| 400 | Dữ liệu được yêu cầu không hợp lệ |
| 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 |
| 886 | Tài khoản học sinh đã bị người dùng xóa |
