请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/school/user/create_student?access_token=ACCESS_TOKEN
请求包体:
{
"student_userid": "zhangsan",
"mobile": "10000000000",
"to_invite": false,
"name": "张三",
"department": [1, 2]
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证。获取方法查看“获取access_token” |
student_userid | 是 | 学生UserID。学校内必须唯一,可以与企业通讯录内成员UserID相同。不区分大小写,长度为1~64个字节。只能由数字、字母和“_-@.”四种字符组成,且第一个字符必须是数字或字母。 |
mobile | 否 | 学生手机号 |
to_invite | 否 | 是否发起邀请,默认为true,仅验证的学校才能发起邀请。 |
name | 是 | 学生姓名,长度为1~32个字符 |
department | 是 | 学生所在的班级id列表,不超过20个 |
当参数字段超过长度限制,那么整个请求会被拦掉。
权限说明:
调用的应用需要满足如下的权限
应用类型 | 权限要求 |
---|---|
自建应用 | 配置到「 家校沟通- 读取和编辑家校通讯录的应用」中 |
代开发应用 | 需拥有「家校沟通」可使用家校通讯录-家校通讯录编辑 权限 |
第三方应用 | 需拥有「家校沟通」使用和编辑 权限 |
注: 从2023年12月1日0点起,不再支持通过系统应用secret调用接口,存量企业暂不受影响 查看详情
返回结果:
{
"errcode": 0,
"errmsg": "created"
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |