Thiết lập số học sinh trên bục giảng (Onstage Student)

Mục lục

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.


HTTP Request Methods #

  • POST

Coding format #

  • UTF-8

Request data #

keyRequiredMore RestrictionsInstructionsDescription
SIDYesNullSchool IDIt is available through the application
safeKeyYesFixed 32-bit all lowercase charactersSchool authentication security keysafeKey=MD5(SECRET+timeStamp)
timeStampYesNullimestamp used by safeKeyUnix Epoch timeStamp is the number of seconds passed by 00:00 (world standard time) on January 1, 1970
courseIdYesNullCourse IDNull
classIdYesNullClass IDNull
seatNumYesMaximum 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.
isHdNo0= non-hd, 1= hd, 2= full hd, all non-1 Numbers, not including 2, are treated as 0Whether the hdSeatNum and isHd pass at least one

Response data #

keyTypeSample valuemeaning
error_infoobjectReturns an array of data
└ errnonumber1Error code
└ errorstring“program normal run”Error list

Sample #

  • HTTP request
POST /partner/api/course.api.php?action=modifyClassSeatNum HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

  • 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"

Response sample(The normal return json packet example) #

  "error_info": {
    "errno": 1,
    "error": "程序正常执行"

Error Code Description #

Error CodeDescription
1Successful execution.
100Incomplete or incorrect parameters.
102No permissions(Security verification failed).
104Operation failure(unknown error).
140The lesson is still ongoing and cannot be edited or deleted
142There is no information about this lesson under the course.
143There is no information about this lesson.
144There is no such course in your the institution.
145The lesson is finished and cannot be edited.
147There is no information about the course.
149The course has been deleted.
153The course has expired.
212The lesson has been deleted.
259The number of students on stage exceeds the limit(The maximum number of students on stage is 12.).
348The number of students on stage cannot be modified within 20 minutes before the lesson starts.
349Failed to modify the number of students on stage.
367Failed to modify the HD-camera attribute of the lesson.
368Do not support HD camera for current number of students on stage.
369Do not support to operate courses and lessons of such type.
466The lesson was created in the ClassIn LMS and cannot be edited via API. Please edit the lesson in the ClassIn LMS.
808Do not support to set dual cameras for the lesson.