1. 批量同步学生信息
说明：通过该接口将在校学生信息批量同步至到梦空间系统。根据学号自动匹配：
若学号已存在，则更新该学生的信息；
若学号不存在，则新增该学生记录。
警告：批量同步学生信息接口将会导致"到梦空间"库中学生信息更新，无法撤回，请谨慎操作！1.1. 协议
- REST-URL:
/user/student/batch/sync - REST-HTTP-Method:
POST - COUTENT-TYPE:
application/x-www-form-urlencoded; charset=UTF-8
1.2. 请求参数
公共参数： 点击查看
业务参数:
| 字段名称 | 类型 | 长度 | 是否必填 | 字段说明 |
|---|---|---|---|---|
| batch_id | String | 64 | YES | 对于每一个学校,传递的每一个批次号都必须保证唯一性,同时对于批次号内的学生明细数据必须保证唯一性;建议格式为,8位当天日期+流水号(3～24位,流水号可以接受数字或英文字符,建议使用数字),示例值:201607192119100001 |
| students | JsonArray | -- | YES | 学生信息明细集合，同一学校内学生不允许重复；一次接口请求最多支持500条明细。 |
students明细:
| 字段名称 | 类型 | 长度 | 是否必填 | 字段说明 |
|---|---|---|---|---|
| studentno | String | 32 | YES | 学号：0706403 |
| gender | int | 1 | YES | 性别（0：男，1:女） |
| name | String | 32 | YES | 姓名：张三 |
| nationcode | String | 16 | YES | 民族：其他,蒙古族,回族,藏族,满族,维吾尔族,苗族,彝族,壮族,布依族,侗族,瑶族,白族,土家族,哈尼族,哈萨克族,傣族,黎族,傈僳族,佤族,畲族,高山族,拉祜族,水族,东乡族,纳西族,景颇族,柯尔克孜族,土族,达斡尔族,仫佬族,羌族,布朗族,撒拉族,毛南族,仡佬族,锡伯族,阿昌族,普米族,朝鲜族,塔吉克族,怒族,乌孜别克族,俄罗斯族,鄂温克族,德昂族,裕固族,保安族,京族,塔塔尔族,独龙族,鄂伦春族,赫哲族,门巴族,珞巴族,基诺族,汉族,外国血统,未知,穿青族,穿青人,摩梭人,革家人 |
| politicalcode | String | 16 | YES | 政治面貌：群众、共青团员、中共预备党员、中共党员、其他 |
| collegename | String | 64 | YES | 院系：计算机系 |
| professional | String | 64 | YES | 专业：软件专业 |
| classno | String | 64 | YES | 班级名称：25软件01班 |
| joindate | String | 10 | YES | 入学时间：2017-07-01 |
| grade | String | 4 | YES | 年级：2017 |
| eductionalSystem | float | 2,1 | NO | 学制，只能填写2、2.5、3、3.5、4、5、6、7、8保留小数点后1位，不填默认为4年学制 |
| birthday | date | -- | NO | 出生日期：1981-01-11 |
| province | String | 32 | NO | 家乡所在省：浙江省 |
| city | String | 32 | NO | 家乡所在市：杭州市 |
| higeSchool | String | 64 | NO | 高中学校名：杭二中 |
| trainLevel | String | 64 | NO | 培养层次，只能填写专科、本科、专升本、硕士研究生、博士研究生 |
1.3. 响应参数
| 字段名称 | 类型 | 字段说明 |
|---|---|---|
| data | String | 如果有数据返回内容 |
| success | Boolean | 请求处理结果状态 |
| msg | String | 接口调用结果提示信息 |
| code | String | 状态码 |
1.4. https请求参数示例
https://openapi.5idream.net/user/student/batch/sync?
openId=20140723000007123&token= 680B3D353FC59D0EA57C96759A63D8FD &sign_type=MD5&sign=680B3D353FC59D0EA57C96759A63D8FD&
info_content={
"batch_id":"201607192119100001",
"students":[{
"studentno": "0706403",
"name": "张三",
"gender": "1",
"politicalcode":"党员",
"nationcode": "汉族",
"collegename": "计算机系",
"professional": "计算机软件",
"eductionalSystem":"3.0",
"classno": "班级",
"joindate": "2017-07-01",
"grade": "2017",
"idCard": "339005192233332321",
"birthday": "1981-01-11",
"province":"浙江省",
"city": "杭州市",
"higeSchool": "杭二中"
}]
}
1.5. 响应参数示例
{
"code": "100",
"data": "swadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffweswadfwfsffwe",
"msg": "操作成功",
"success": true
}
1.6. data解密后格式
{
"batchid" : "201607192119100001"
}
1.7. 异常响应说明
| 编码 | 字段说明 | 可采取行动 |
|---|---|---|
| -10008 | batch_id批次号必传 | 规范传递批次号 |
| -10009 | 一次接口请求最多支持500条明细上传 | 规范传递批量数据量 |
| -10010 | 批量操作数据校验不通过 | 根据返回的error提示更改数据 |