添加学生
添加学生（机构下添加学生），需要 SID，safekey，timeStamp，学生账号，学生姓名。
这是对接过程的一个必要接口调用。 为确保接口调用正确，需注意：
- 这个接口对应后台-学生管理-添加学生。注册用户必须添加为机构下学生，后继才能对其进行排课操作。如果用户并非机构下学生，直接用接口对其排课会返回错误。
- ClassIn新注册用户可以在注册接口里直接添加机构学生，参考注册接口。 如果非新用户，注册接口返回135，则需要调用本接口添加机构学生。
URL
https://root_url/partner/api/course.api.php?action=addSchoolStudent
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 (世界标准时间) 起经过的秒数 |
| studentAccount | 是 | 手机号或者是邮箱，格式为：00国家号-手机号；注意：中国大陆手机号不写国家号 | 学生账号 | 例如：美国手机号 1 (800) 643-7676 填成 001-8006437676；中国大陆手机号填成 15800000001 |
| studentName | 是 | 1-24字，不区分中英文，超过24会自动截取为24字 | 学生名字，会显示在 eeo.cn 管理后台的 学生管理 页面 | 无 |
响应参数
| 参数名 | 类型 | 示例值 | 含义 |
|---|---|---|---|
| error_info | object | 返回信息对象 | |
| └ errno | number | 1 | 错误代码 |
| └ error | string | "程序正常执行" | 错误详情 |
示例
- HTTP 请求
POST /partner/api/course.api.php?action=addSchoolStudent HTTP/1.1
Host: root_url
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 | 此号码段不合法 |
| 886 | 学生账号已注销 |