- The editSchoolStudent interface is to edit students' names. The API call requires SID, safeKey, timeStamp, UID and student name, and returns an instruction after execution.
- The interface only changes students' names displayed on the management console on classin.com. It does not modify users nicknames displayed in the ClassIn app. For users also in teacher identity, the API call does not edit teacher names.
URL
https://api.eeo.cn/partner/api/course.api.php?action=editSchoolStudent
HTTP Request Methods
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 |
studentUid |
Yes |
usere UID |
User UID returned after successful registration |
Null |
studentName |
Yes |
1-24 characters,No distinction between Chinese and English, more than 24 words will be intercepted into 24 words |
student name |
eeo.cn background display |
Response data
key |
Type |
Sample value |
meaning |
error_info |
object |
|
Return message object |
└ errno |
number |
1 |
The error code |
└ error |
string |
"Normal execution" |
Error list |
Sample
POST /partner/api/course.api.php?action=editSchoolStudent HTTP/1.1
root_url
application/x-www-form-urlencoded
no-cache
SID=2339736&safeKey=51cf7854e932de0df9f37fa7dcbf463c&timeStamp=1492871773&studentUid=16615&studentName=dan
- 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 "studentUid=14165" \
-d "studentName=dan" \
"https://api.eeo.cn/partner/api/course.api.php?action=editSchoolStudent"
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 |
Don't have permissions(Security verification failed). |
104 |
Operation failed (unknown error). |
228 |
There is no such student in the institution. |