接口描述
描述:更新企业部门信息,仅企业下具有部门编辑权限的用户可更新部门。不支持 OAuth2.0 鉴权访问。
调用方式:PUT
接口请求域名:
https://api.meeting.qq.com/v1/departments/{departmentId}
输入参数
HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称 | 必选 | 参数类型 | 参数描述 |
---|---|---|---|
userid | 是 | String | 接口调用者 userid,必须为企业下具有部门编辑权限的用户。 |
parent_department_id | 是 | String | 上级部 ID,若需要将部门变更为主部门,此字段传0。 |
department_name | 是 | String | 部门名称,至少1个字符,长度不超过32个字符。 |
输出参数
成功输出以下字段,失败则返回 错误码 和错误信息。
参数名称 | 参数类型 | 参数描述 |
---|---|---|
department_full_name | String | 部门全称。 |
department_id | String | 部门 ID。 |
department_name | String | 部门名称。 |
is_main_department | Boolean | 是否是主部门。 |
parent_department_id | String | 上级部门 ID。 |
user_count | Integer | 部门人数。 |
示例
输入示例
PUT
https://api.meeting.qq.com/v1/departments/e3ce08********1f05db4de921fc2c2d
{
"userid": "meeting4548079",
"department_name": "test-子部门-03",
"parent_department_id": "e3ce08****************e921fc2c2"
}
输出示例
{
"department_id": "a45edc92c****************c9eb537",
"department_name": "test-子部门-03",
"department_full_name": "test-主部门-01/test-子部门-03",
"is_main_department": false,
"user_count": 0,
"parent_department_id": "1519****************d9da464bf856"
}
下载 更新部门.pdf
Copyright(C)2023 HFBangFu Inc. All Rights Reserved
皖ICP备12017563号-5