添加学生

添加学生（原名机构下添加学生），需要 SID，safekey，timeStamp，学生账号，学生姓名，studentAccount。返回的数据中包括每节课添加执行后的说明。新注册的用户可以直接调用此接口添加到本机构下（已添加到课程/课节下的学生无须调用此接口）。

URL

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

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 (世界标准时间) 起经过的秒数
studentAccount 是 格式为：00国家号-手机号；注意：中国大陆手机号不写国家号 学生账号 例如：美国手机号 1 (800) 643-7676 填成 001-8006437676；中国大陆手机号填成 15800000001，也可以用给您分配的虚拟号，虚拟号认为是中国大陆号码
studentName 是 1-24字，不区分中英文，超过24会自动截取为24字 学生名字/昵称，会同步显示在 sdk管理后台的 学生管理 页面和客户端教室里面 无

响应参数

参数名 类型 示例值 含义
error_info object 返回信息对象
└ errno number 1 错误代码
└ error string "程序正常执行" 错误详情

示例

  • HTTP 请求
POST /partner/api/course.api.php?action=addSchoolStudent HTTP/1.1
Host: www.classin-sdk.com
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

SID=2339736&safeKey=dcbc0d041c043f3a4decabe6d24e61dd&timeStamp=1493712683&studentAccount=18516900101&studentName=Jeck
  • Shell cURL 模拟请求指令
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
      -d "SID=1234567" \
      -d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
      -d "timeStamp=1484719085" \
      -d "studentAccount=18516900101" \
      -d "studentName=小红" \
      "https://root_url/partner/api/course.api.php?action=addSchoolStudent"

响应示例（正常时返回的 json 数据包示例）

{
  "error_info": {
    "errno": 1,
    "error": "程序正常执行"
  }
}

错误码说明

错误码 说明
1 表示成功执行
100 表示参数不全或错误
102 表示无权限（安全验证没通过）
104 表示操作失败（未知错误）
113 表示手机账户未注册
114 表示服务器异常
128 表示机构账号不能添加为学生
133 已是机构学生
134 表示手机号不合法
288 此号码段不合法
863 添加学生成功，修改IM昵称失败

results matching ""

    No results matching ""