请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/department/create?access_token=ACCESS_TOKEN
请求包体:
{
"name": "广州研发中心",
"name_en": "RDGZ",
"parentid": 1,
"order": 1,
"id": 2
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
name | 是 | 部门名称。同一个层级的部门名称不能重复。长度限制为1~64个UTF-8字符,字符不能包括\:*?"<>| |
name_en | 否 | 英文名称。同一个层级的部门名称不能重复。需要在管理后台开启多语言支持才能生效。长度限制为1~64个字符,字符不能包括\:*?"<>| |
parentid | 是 | 父部门id,32位整型 |
order | 否 | 在父部门中的次序值。order值大的排序靠前。有效的值范围是[0, 2^32) |
id | 否 | 部门id,32位整型,指定时必须大于1。若不填该参数,将自动生成id |
权限说明:
第三方仅通讯录应用可以调用。
注意,部门的最大层级为15层;部门总数不能超过3万个;每个部门下的节点不能超过3万个。建议保证创建的部门和对应部门成员是串行化处理。
返回结果:
{
"errcode": 0,
"errmsg": "created",
"id": 2
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
id | 创建的部门id |