接口描述
描述：创建企业部门，仅企业下具有部门编辑权限的用户可创建部门。不支持 OAuth2.0 鉴权访问。
调用方式：POST
接口请求域名：
https://api.meeting.qq.com/v1/departments
输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
| 参数名称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|
| userid | 是 | String | 接口调用者 userid，必须为企业下具有部门编辑权限的用户。 |
| department_name | 是 | String | 部门名称，至少1个字符，长度不超过32个字符。 |
| 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 | 部门人数。 |
示例
输入示例
POST
https://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"
}
下载 创建部门.pdf
文章内容是否对您有帮助？
有帮助
无帮助
能否告知我们这篇文章的问题？（选填）