Synchronize Student Class Nicknames
This interface supports synchronizing the "Student Management - Name" from the backend to the class of the student.
Interface Description:
- Supports batch synchronization, with a limit of 100 studentUids per request.
- Only synchronizes class nicknames for courses that have not yet concluded.
URL
https://root_url/schooluser/modifyCourseStudentNickName
HTTP Request Methods
Request Parameters
Key |
Required |
Type |
Description |
X-EEO-SIGN |
Yes |
string |
Signature; see here for generation rules |
X-EEO-UID |
Yes |
string |
Institution SID |
X-EEO-TS |
Yes |
string |
Timestamp |
Body Parameters
Key |
Required |
Type |
Description |
Rules Description |
studentUids |
Yes |
array |
Refresh only class nicknames for classes not yet concluded |
Maximum 100 studentUids |
Response Parameters
Parameter Name |
Type |
Example Value |
Meaning |
code |
integer |
1 |
Error code |
msg |
string |
"Execution successful" |
Error message |
data |
array |
[] |
Array of return information |
└ studentUid |
integer |
1445886 |
Student UID |
└ code |
integer |
1 |
Error code |
└ msg |
string |
"Execution successful" |
Error message |
Example
POST /schooluser/modifyCourseStudentNickName HTTP/1.1
root_url
365456d0454e9b0dd793c47e65727e84
2669800
1732268163
application/json
26
{
"studentUids": [
1445886
]
}
- Shell cURL Simulation Request Command
curl -X POST \
-H 'Host: root_url' \
-H 'X-EEO-SIGN: 365456d0454e9b0dd793c47e65727e84' \
-H 'X-EEO-UID: 2669800' \
-H 'X-EEO-TS: 1732268163' \
-H 'Content-Type: application/json' \
-d '{"studentUids": [1445886]}' \
'https://root_url/schooluser/modifyCourseStudentNickName'
Response Example (Example of json data packet returned when successful)
{
"code": 1,
"msg": "程序正常执行",
"data": [
{
"studentUid": 1445886,
"code": 1,
"msg": "程序正常执行"
}
]
}
Error Code Description
Error Code |
Description |
101001001 |
Business parameter error |
101002005 |
Signature exception |
101002006 |
Timestamp expired |
101002008 |
Timestamp does not exist |
101004005 |
Internal service call failed |
110100067 |
Failed to synchronize class nickname |
121601058 |
Institution does not exist |
121601059 |
No such student under the institution |
121601060 |
Student count exceeds limit of 100 |