接口描述
描述:创建企业部门,仅企业下具有部门编辑权限的用户可创建部门。不支持 OAuth2.0 鉴权访问。
请求方式:POST
自建应用权限点:管理企业部门。
接口请求域名:
https://api.meeting.qq.com/v1/departments
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
userid | 是 | String | 接口调用者 userid,必须为企业下具有部门编辑权限的用户。 |
department_name | 是 | String | 部门名称,至少1个字符,长度不超过50个字符。 |
parent_department_id | 否 | String | 上级部门 ID。 |
输出参数
参数名称 | 参数类型 | 参数描述 |
department_full_name | String | 部门全称。 |
department_id | String | 部门 ID。 |
department_name | String | 部门名称。 |
is_main_department | Boolean | 是否是主部门。 |
parent_department_id | String | 上级部门 ID。 |
user_count | Integer | 部门人数。 |
错误码列表
状态码 | 错误码 | 错误描述 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
400 | 500014 | 账号无权限。 |
500 | 190443 | 用户无部门操作权限。场景: 1. 用户无编辑部门信息权限 2. 用户无查看部门信息权限 |
500 | 20004 | 部门名称已经存在。 |
示例
输入示例
POSThttps://api.meeting.qq.com/v1/v1/departments{"userid": "meeting4548079","department_name": "test-子部门-03","parent_department_id": "e3ce0856**************e921fc2c2"}
输出示例
{"department_id": "a45edc9****************54c9eb537","department_name": "test-子部门-03","department_full_name": "test-主部门-01/test-子部门-03","is_main_department": false,"user_count": 0,"parent_department_id": "1519****************d9da464bf856"}