api:api_dept_adduser

在组织架构根节点新增员工

在根组织节点下,新增一名员工,QQ号码为默认分配,角色为系统缺省角色。

请求地址

https://openapi.b.qq.com/api/dept/adduser

请求方式

post

请求样例

请求频率

6次/分钟(详见频率限制)

请求参数

所有向企业QQ发起的请求均包含该公共参数

此请求还需要如下参数

字段名称 字段类型 字段说明
account string 必填,由字母、数字组成,点(.)减号(-)下划线(_)
不能放在开头或结尾,也不能连续出现
name string 必填,中文名字等,长度24字节,UTF-8编码
gender int 非必填,1-男;2-女;默认值 1
mobile string 非必填,中国大陆手机号码格式,11位数字,不支持别的
password string 非必填,员工初始密码,要求密码长度必须6-16位,且包含以下情况的三种:字母、数字、符号!、@、*等,默认值为系统缺省密码
p_dept_id int 非必填,父组织ID,默认值为1, 表示根组织
display_order int 非必填,员工在父组织中的顺序,从0开始依次递增
title string 非必填,员工职务,长度24字节,UTF-8编码
bind int 非必填,强制绑定手机号,为1时为强制绑定

返回结果

{
  "ret": 0,
  "msg": "调用成功",
  "data": {
    "open_id": "a2811b0d07d2d4dc9a11f5b7121c50ce"
  }
}
字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 如果ret不为0,会有相应的错误信息提示,UTF-8编码。
data object 只有一个键open_id,表示新添加成功的帐号的open_id。

返回

api/api_dept_adduser.txt · 最后更改: 2016/04/22 17:05 (外部编辑)