Modify Number of Students on Stage
To modify the number of students on stage, you need to pass the required parameters, SID, safeKey, timeStamp, Course ID, Lesson ID, seatNum
. You should refer to the error code and the related description in the response to make adjustments. The maximum value of seatNum
that can be modified is the maximum number of students on stage of the school. If you want to increase the limit, please contact the account manager.
Notes: Pass at least one of seatNum
and isHd
.
URL
https://api.eeo.cn/partner/api/course.api.php?action=modifyClassSeatNum
HTTP Request Methods
- POST
Coding format
- UTF-8
Request data
key | Required | More Restrictions | Instructions | Description |
---|---|---|---|---|
SID | Yes | Null | School ID | It is available through the eeo.cn application |
safeKey | Yes | Fixed 32-bit all lowercase characters | School authentication security key | safeKey=MD5(SECRET+timeStamp) |
timeStamp | Yes | Null | imestamp used by safeKey | Unix Epoch timeStamp is the number of seconds passed by 00:00 (world standard time) on January 1, 1970 |
courseId | Yes | Null | Course ID | Null |
classId | Yes | Null | Class ID | Null |
seatNum | Yes | Maximum number of students will be changed to the maximum number of students in the school,bigger than the maximum number of people in the school will default to the maximum number of people on stage(12) | on stage students number(Not including teacher) | For example:Change to 1v6,this parameter value should is 6. |
isHd | No | 0= non-hd, 1= hd, 2= full hd, all non-1 Numbers, not including 2, are treated as 0 | Whether the hd | SeatNum and isHd pass at least one |
Response data
key | Type | Sample value | meaning |
---|---|---|---|
error_info | object | Returns an array of data | |
└ errno | number | 1 | Error code |
└ error | string | "program normal run" | Error list |
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 | Successful execution. |
100 | Incomplete or incorrect parameters. |
102 | No permissions(Security verification failed). |
104 | Operation failure(unknown error). |
140 | The lesson is still ongoing and cannot be edited or deleted |
142 | There is no information about this lesson under the course. |
143 | There is no information about this lesson. |
144 | There is no such course in your the institution. |
145 | The lesson is finished and cannot be edited. |
147 | There is no information about the course. |
149 | The course has been deleted. |
153 | The course has expired. |
212 | The lesson has been deleted. |
259 | The number of students on stage exceeds the limit(The maximum number of students on stage is 12.). |
348 | The number of students on stage cannot be modified within 20 minutes before the lesson starts. |
349 | Failed to modify the number of students on stage. |
367 | Failed to modify the HD-camera attribute of the lesson. |
368 | Do not support HD camera for current number of students on stage. |
369 | Do not support to operate courses and lessons of such type. |
466 | The lesson was created in the ClassIn LMS and cannot be edited via API. Please edit the lesson in the ClassIn LMS. |
808 | Do not support to set dual cameras for the lesson. |