添加老师
说明：
- 添加老师，需要 SID，safekey，timeStamp，老师的手机号、姓名和头像、老师账号，其中头像以二进制流的类型发送。
- 中国大陆手机号不填写国家号，否则提示不合法。
- 接口返回值的是机构和老师的关系的 ID，这个ID可以忽略 ;
这是对接过程的一个必要接口调用。 为确保接口调用正确，需注意：
- 这个接口对应后台-教师管理-添加教师。注册用户必须添加为机构下老师，后继才能对其进行排课操作。如果用户并非机构下老师，直接用接口对其排课会返回错误。
- ClassIn新注册用户可以在注册接口里直接添加机构老师，参考注册接口。 如果非新用户，注册接口返回135，则需要调用本接口添加机构老师。
URL
https://root_url/partner/api/course.api.php?action=addTeacher
HTTP Request Methods
- POST
编码格式
- UTF-8
请求参数
| key | 必填 | 更多限制 | 说明 | 规则说明 |
|---|---|---|---|---|
| SID | 是 | 无 | 机构认证 ID | 通过 eeo.cn 申请机构认证可获得 |
| safeKey | 是 | 固定 32 位全小写字符 | 机构认证安全密钥 | safeKey=MD5(SECRET+timeStamp) |
| timeStamp | 是 | 无 | 当前调用接口20分钟以内的 Unix Epoch 时间戳 | Unix Epoch 时间戳是 1970年1月1日 00:00:00 (世界标准时间) 起经过的秒数 |
| teacherAccount | 是 | 手机号或者是邮箱，格式为：00国家号-手机号；注意：中国大陆手机号不写国家号 | 老师的账号 | 例如：美国手机号 1 (800) 643-7676 填成 001-8006437676；中国大陆手机号填成 15800000001 |
| teacherName | 是 | 1-24字，不区分中英文，超过24字会自动截取为24字 | 老师的姓名，会显示在 eeo.cn 管理后台的 教师管理 页面 | 无 |
| Filedata | 否 | 二进制流 | 老师的头像 | 无 |
响应参数
| key | 类型 | 示例值 | 含义 |
|---|---|---|---|
| data | number | 14163 | 机构和老师的关系 ID |
| error_info | object | 返回信息对象 | |
| └ errno | number | 1 | 错误代码 |
| └ error | string | "程序正常执行" | 错误详情 |
示例
- HTTP 请求
POST /partner/api/course.api.php?action=addTeacher HTTP/1.1
Host: root_url
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
SID=2339736&safeKey=8d3fb00ceddd29638e2d5dd12d69841d&timeStamp=1492793638&teacherAccount=18516900101&teacherName=hubert&Filedata=@~/photo.jpg
- Shell cURL 模拟请求指令
curl -H "Content-Type: multipart/form-data" -X "POST" \
-d "SID=1234567" \
-d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
-d "timeStamp=1484719085" \
-d "teacherAccount=18516900101" \
-d "teacherName=hubert" \
-d "Filedata=@~/photo.jpg" \
"https://root_url/partner/api/course.api.php?action=addTeacher"
响应示例（正常时返回的 json 数据包示例）
{
"data": 14161,
"error_info": {
"errno": 1,
"error": "程序正常执行"
}
}
错误码说明
| 错误码 | 说明 |
|---|---|
| 1 | 表示成功执行 |
| 100 | 表示参数不全或错误 |
| 102 | 表示无权限（安全验证没通过） |
| 103 | 图片放入服务器失败 |
| 104 | 表示操作失败（未知错误） |
| 113 | 手机账户未注册 |
| 114 | 服务器异常 |
| 122 | 老师账号不合法 |
| 131 | 注册失败 |
| 133 | 该帐户已经在机构下存在 |
| 400 | 表示请求数据不合法 |
| 288 | 此号码段不合法 |
| 845 | 超出机构老师最大启用数量 |
| 884 | 老师帐号已注销 |