Edit class message
Modify the lesson information,SID, safekey, timeStamp, course ID, class name, class time, teacher account, teacher name, cloud disk directory ID, recording, live broadcasting, playback, teaching assistant, teacher UID, teaching assistant UID, etcSID, safeKey, ttimeStamp, courseId, classId are required,Fill in any of the other parameters that need to be modified (edit any of the three parameters: recording, live streaming, playback, and the other two parameters must be filled in,The other two parameters are required.Otherwise, it will not take effect.)。Returns the success statement after execution, to change the number of stage calls Edit Students On The Stage In The Class。
Notes:
- Class name, class time, cloud disk resources and number of people on the stage cannot be changed within 20 minutes before class begins.
- If the teacher changes the class during the class, the teacher will quit the class.
- If recording is set for a class (live streaming is not set), more_data returns the live player address for the class, with the pull stream address empty.
- More_data returns the live player address and pull stream address of the lecture if the lecture is recorded and streamed live.
- If you edit or set other parameters and do not change any of the recording/live/call back parameters, return more_data as created.
- The teaching assistants have been set up before the class, and cannot be replaced or deleted after the class begins;If no ta is set after class, ta can be added.
URL
https://api.eeo.cn/partner/api/course.api.php?action=editCourseClass
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 |
className | No | Null | Class name | Null |
beginTime | No | Null | Class time | Null |
endTime | No | If you fill out the beginTime, you must fill in endTime | Break time | Null |
folderId | No | Default is the school's top-level directory ID | Cloud driver directory ID | Null |
record | No | Default is 0 ,All non-1 Numbers will be treated as 0 | Record the class(0 close,1 open) | Null |
live | No | The default is 0, and all non-1 Numbers will be treated as 0 for | live (0 shutoff, 1 open) | Null |
replay | No | The default is 0, and all non-1 Numbers will be treated as 0 for | playback (0 off, 1 on) | Null |
assistantAccount | No | To be deprecated at 1st May!Please use assistantUid! must be a teacher in this school before he can be appointed as a teaching assistant. If you want to delete the teaching assistant, this is "0". Format is:00 Country code-Mobile number;Mainland China mobile phone number does not write country number | teaching assistant | Example:American mobile number 1 (800) 643-7676 send 001-8006437676;Chinese Mainland mobile Numbers send 13701237634 |
isAutoOnstage | No | 0=automatic,1=Don't automatically,Don't fill in,Do not fill, do not modify,Any number that's not a 1, it's treated as a 0 | Whether students enter the classroom automatically | There is no |
classIntroduce | No | 0-1000 words, no distinction between Chinese and English, more than 1000 words will automatically cut into 1000 words | Class introduction | There is no |
teacherUid | No | Null | Teacher UID | Register the user UID returned by the user interface |
assistantUid | No | Either assistantAccount or assistantUid. If assistantUid is passed to assistantAccount at the same time, the assistantUid parameter shall prevail | ta UID | Register the user UID returned by the user interface |
Request data
key | Required | More Restrictions | Instructions | Description |
---|---|---|---|---|
more_data | array | [] | Returns an array of Data information | |
└ live_url | string | https://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164d | Lesson live player address | |
└ live_info | array | [] | Returns an array of Data information | |
└ RTMP | string | "rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd" | Pull flow address | |
└ HLS | string | "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd" | Pull flow address | |
└ FLV | string | "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd" | Pull flow address | |
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=editCourseClass 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&className=chinese&beginTime=1493434330&endTime=1493444330&teacherAccount=18503160003&folderId=&record=1&live=1&replay=1
- 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 "className=测试课程" \
-d "beginTime=1484739085" \
-d "endTime=1484739085" \
-d "teacherUid=1001001" \
-d "folderId=1" \
-d "record=1" \
-d "live=1" \
-d "replay=1" \
-d "assistantUid=1001002" \
"https://api.eeo.cn/partner/api/course.api.php?action=editCourseClass"
Response sample(The normal return json
packet example)
{
"more_data": {
"live_url": "https://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164d",
"live_info": {
"RTMP": "rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
"HLS": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
"FLV": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd"
}
},
"error_info": {
"errno": 1,
"error": "程序正常执行"
}
}
Error code instruction
Error code | Instruction |
---|---|
1 | Expression successful execution. |
100 | Expression parameter not all or error. |
102 | Expression dont have permissions(Security verification failed). |
104 | Expression operation failure(Unknown error). |
114 | Expression Server exception. |
119 | Expression the end time must be late. |
120 | Expression at least one minute after class. |
124 | Expression you can't change the time of class in the first minute. |
136 | Expression there is no teacher under the agency, please add the teacher under the agency. |
140 | Expression the class is under class and cannot be edited and deleted. |
142 | Expression this course does not have this section information. |
143 | Expression no such information. |
144 | Expression there is no such course under the agency. |
145 | Expression the class is over. |
160 | Expression there is no cloud driver directory under the school. |
165 | Means that a lesson should not be less than 15 minutes and not more than 24 hours, |
172 | Expression the students under the class cannot be added to the teacher. |
173 | Expression the audit of the class cannot be added to the teacher. |
212 | Expression this section has been removed. |
268 | Expression The starting time of class festival must be within two years |
282 | Expression the class section changes the success, records the class parameter setting error, records the class modification failed. |
283 | Expression the class section is successful, the course is not open in the 20 minutes before the class starts, and the course modification fails. |
284 | Expression the class section has been modified successfully, video service has a problem, and the recording session has failed. |
325 | Expression drop-in students cannot be added as teachers |
326 | Indicates that the teaching assistant failed to join the teacher list in class |
327 | The ta failed to cancel the class |
328 | Expression the teaching assistant under the class cannot be added as teacher. |
330 | Expression the teaching assistant account format is not correct. |
318 | Expression the teaching assistant doesn't exist. |
319 | Expression the students under the course cannot be added as teaching assistant. |
320 | Expression the attend under the course cannot be added as teaching assistant. |
321 | Expression the drop-in students cannot be added as teaching assistant. |
322 | Expression the teacher under the class cannot be added as teaching assistant. |
323 | Expression teaching assistant fails to buy class. |
324 | Expression teacher in class failed to join the teacher list. |
326 | Expression the teacher's list of teaching assistant in the class failed. |
327 | Expression the teaching assistant failed to cancel the class. |
369 | Expression open class does not support this operation. |
387 | indicates that the teacher has been suspended. |
388 | Indicates that the ta has been discontinued. |
400 | Indicates that the request data is not valid |
800 | Means the teacher is out of use |
804 | The ta is out of use |
825 | Indicates that the session editing was successful, while the session introduction setting failed |