编辑老师
编辑老师,需要 SID、safekey、timeStamp、提供老师与机构对应的关系 ID、老师的姓名和老师的头像,其中头像的类型为二进制流类型。返回执行后的说明。
URL
https://root_url/partner/api/course.api.php?action=editTeacher
HTTP Request Methods
编码格式
请求参数
key |
必填 |
更多限制 |
说明 |
规则说明 |
SID |
是 |
无 |
机构认证 ID |
通过 sdk管理后台 申请机构认证可获得 |
safeKey |
是 |
固定 32 位全小写字符 |
机构认证安全密钥 |
safeKey=MD5(SECRET+timeStamp) |
timeStamp |
是 |
无 |
当前调用接口20分钟以内的 Unix Epoch 时间戳 |
Unix Epoch 时间戳是 1970年1月1日 00:00:00 (世界标准时间) 起经过的秒数 |
st_id |
否 |
与 teacherUid 二选一 |
老师和机构对应的 ID |
如果与 teacherUid 两个参数同时传递,则只使用 st_id |
teacherUid |
否 |
与 st_id 二选一 |
手机账号的 UID |
如果与 st_id 两个参数同时传递,则只使用 st_id |
teacherName |
是 |
1-24位字符,不区分中英文,超过24字会截取为24字 |
老师的姓名,会同步显示在sdk管理后台的 教师管理 页面和客户端教室里面 |
无 |
Filedata |
否 |
二进制流 |
老师的头像 |
无 |
响应参数
key |
类型 |
示例值 |
含义 |
error_info |
object |
|
返回信息对象 |
└ errno |
number |
1 |
错误代码 |
└ error |
string |
"程序正常执行" |
错误详情 |
示例
POST /partner/api/course.api.php?action=editTeacher HTTP/1.1
www.classin-sdk.com
application/x-www-form-urlencoded
no-cache
SID=2339736&safeKey=51cf7854e932de0df9f37fa7dcbf463c&timeStamp=1492871773&st_id=16615&teacherName=&Filedata=
curl -H "Content-Type: multipart/form-data" -X "POST" \
-d "SID=1234567" \
-d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
-d "timeStamp=1484719085" \
-d "st_id=14165" \
-d "teacherName=dan" \
-d "Filedata=@~/photo.jpg" \
"https://root_url/partner/api/course.api.php?action=editTeacher"
响应示例(正常时返回的 json
数据包示例)
{
"error_info": {
"errno": 1,
"error": "程序正常执行"
}
}
错误码说明
错误码 |
说明 |
1 |
表示成功执行 |
100 |
表示参数不全或错误 |
102 |
表示无权限(安全验证没通过) |
103 |
图片放入服务器失败 |
104 |
表示操作失败(未知错误) |
219 |
老师信息不存在 |
866 |
编辑老师信息成功,修改IM昵称失败 |