同步学生班级昵称
接口功能: 此接口支持将后台“学生管理-姓名”同步到学生所在的所有未结课班级
接口说明:
- 支持批量同步,studentUids单次上限为100
- 仅同步至未结课课程的班级昵称
URL
https://root_url/schooluser/modifyCourseStudentNickName
HTTP Request Methods
编码格式
请求参数
| key |
必填 |
类型 |
说明 |
| X-EEO-SIGN |
是 |
string |
签名 生成规则见这里 |
| X-EEO-UID |
是 |
string |
机构SID |
| X-EEO-TS |
是 |
string |
时间戳 |
Body 参数
| key |
必填 |
类型 |
说明 |
规则说明 |
| studentUids |
是 |
数组 |
仅刷新未结课班级的班级昵称 |
studentUids最大100 |
响应参数
| 参数名 |
类型 |
示例值 |
含义 |
| code |
integer |
1 |
错误码 |
| msg |
string |
"程序正常执行" |
错误信息 |
| data |
array |
[] |
返回信息数组 |
| └ |
studentUid |
integer |
1445886 |
| └ |
code |
integer |
1 |
错误码 |
| └ |
msg |
string |
"程序正常执行" |
错误信息 |
示例
POST /schooluser/modifyCourseStudentNickName HTTP/1.1
root_url
365456d0454e9b0dd793c47e65727e84
2669800
1732268163
application/json
26
{
"studentUids": [
1445886
]
}
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'
响应示例(正常时返回的 json 数据包示例)
{
"code": 1,
"msg": "程序正常执行",
"data": [
{
"studentUid": 1445886,
"code": 1,
"msg": "程序正常执行"
}
]
}
错误码说明
| 错误码 |
说明 |
| 101001001 |
业务参数错误 |
| 101002005 |
签名异常 |
| 101002006 |
时间戳过期 |
| 101002008 |
时间戳不存在 |
| 101004005 |
服务内部调用失败 |
| 110100067 |
同步班级昵称失败 |
| 121601058 |
不存在该机构 |
| 121601059 |
机构下无此学生 |
| 121601060 |
学生数量超过限制100 |