添加老师

添加老师，需要 SID，safekey，timeStamp，老师的手机号、姓名和头像、老师账号，其中头像以二进制流的类型发送。返回的是机构和老师的关系的 ID (在编辑老师信息接口中需要用到);注意：中国大陆手机号不填写国家号，否则提示不合法。

URL

https://root_url/partner/api/course.api.php?action=addTeacher

HTTP Request Methods

  • POST

编码格式

  • UTF-8

请求参数

key 必填 更多限制 说明 规则说明
SID 是 无 机构认证 ID 通过 sdk管理后台 申请机构认证可获得
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字 老师的姓名，会同步显示在sdk管理后台的 教师管理 页面和客户端教室里面 无
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: www.classin-sdk.com
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 此号码段不合法
865 添加老师成功，修改IM昵称失败

results matching ""

    No results matching ""