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	班级：0706402
joindate	String	10	YES	入学时间：2017-07-01
grade	String	4	YES	年级：2017
idCard	String	32	YES	身份证号码：339005192233332321
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提示更改数据

results matching ""

No results matching ""