Add Students/Auditing Students to Course (Single)
Student are added to the course(single),Need SID, safekey, timeStamp, course ID, student and audit identification (1 is students, 2 is auditing), add account number, name to add, etc. Returns the description after execution.
URL
https://api.eeo.cn/partner/api/course.api.php?action=addCourseStudent
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 |
identity | Yes | Null | Student and audit identification(1 is student,2 is attend) | Null |
studentName | No | Null | Only take effect when indentity=2 | Null |
studentUid | Yes | Null | student UID | Register the user UID returned by the user interface |
Response Data
Key | Type | Sample Value | Meaning |
---|---|---|---|
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=addCourseStudent HTTP/1.1
Host: www.eeo13.test
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=1002289&safeKey=bd53aabe936c69a85f3d2e329ab8e080&timeStamp=1493030202&courseId=1431&identity=1&studentUid=12234&studentName=Mary
- 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 "identity=1" \
-d "studentUid=12234" \
-d "studentName=张三" \
"https://api.eeo.cn/partner/api/course.api.php?action=addCourseStudent"
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 permission(Security verification failed.). |
104 | Operation failure(Unknown error). |
113 | The mobile phone number has not been registered yet. |
114 | Server exception. |
129 | Course teachers cannot be set as students. |
130 | Exceeds the number of accounts that can be added. |
134 | Illegal mobile phone number. |
144 | There is no such course in your institution. |
147 | There is no information about the course. |
149 | The course has been deleted. |
153 | The course is expired and cannot be edited. |
155 | Student array data cannot be null. |
163 | The course student already exists. |
164 | The course auditing student already exists. |
174 | Teachers cannot be set as auditing students. |
228 | There is no such student in your institution. |
332 | Course teachers or co-teachers cannot be set as course students or course auditing students. |
333 | The course advisor cannot be set as a course student. |
369 | Do not support to operate this type of courses and lessons(public course). |
400 | The requested data is illegal. |
841 | Successfully added students to the course. Failed to synchronize class nicknames. |
886 | The student's account has been deleted by the user. |
887 | The auditing student's account has been deleted by the user. |