描述
批量添加学员信息到分组,单次最多添加50位学员。
接口地址
http://api-class.e.vhall.com/api/class/whitelist/batch-add-users-info
请求参数
公共参数需要每次请求都附带上,详细内容请参考公共参数
参数名 | 类型 | 必选 | 说明 |
---|---|---|---|
child_id | int | 否 | 子账户id |
group_id | int | 是 | 分组id |
member_data | array | 是 | 学员信息,,member_data数组中的user_name字段为学员名称为必填项例如 张三/李四/王五,member_data数组中的mobile字段为学员手机号为必填项 例如"13111112222",member_data数组中的gender字段为学员性别的意思非必填项 例如 男/女/M/W/MAN/WOMAN/男士/女士/BOY/GIRL/男人/女人,member_data数组中的password、confirm_password字段为学员密码和确认密码的意思非必填项,设置密码后如账号开通网校则学员可使用此密码登录网校,密码长度为8-32位 ,member_data数组中的wechat字段为学员微信号的意思非必填项 例如"wodeweixinhao" ,member_data数组中的remarks字段为学员备注的意思非必填项 例如"这是一个备注" 具体使用请参考下方示例 |
示例
//单选题示例
curl -d 'group_id=1110&child_id=125&member_data=[{"user_name":"小王","mobile":"13111112222","gender":"男","password":"xiaowang1234567","confirm_password":"xiaowang1234567","wechat":"xiaowang","remarks":"这是小王的信息"},{"user_name":"小花","mobile":"13111112226","gender":"女","password":"xiaoying1234567","confirm_password":"xiaoying1234567","wechat":"xiaoying","remarks":"这是小英的信息"}] -X POST http://api-class.e.vhall.com/api/class/whitelist/batch-add-users-info?xxxxxxxxxxxxxxxxx
响应参数
参数名 | 类型 | 说明 |
---|---|---|
success_num | int | 创建成功的条数 |
failed_num | int | 创建失败的条数 |
error_num | int | 信息错误的条数,比如姓名和手机号必填字段未填写 |
repeat_num | int | 重复的条数 |
响应示例
{
"code": "200",
"msg": "success",
"data": {
"success_num":2,
"failed_num":0,
"error_num":0,
"repeat_num":0,
}
}
错误码
code | 含义 |
---|---|
20000 | 子账号不存在 |