通过 userid 获取用户详情
接口描述
描述：使用 userid 获取企业用户详情。企业 secret 鉴权用户可获取该用户所属企业下的用户详情，暂不支持 OAuth2.0 鉴权用户通过 userid 查询用户详情。
调用方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/users/{userid}
输入参数
以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
| 参数名称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|
| userid | 是 | String | 调用方用于标示用户的唯一 ID（企业内部请使用企业唯一用户标识；OAuth2.0 鉴权用户请使用 openId）。 <br>企业唯一用户标识说明：<br>1. 企业对接 SSO 时使用的员工唯一标识 ID；<br>2. 企业调用创建用户接口时传递的 userid 参数。 |
输出参数
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| username | String | 用户昵称。 |
| update_time | String | 更新时间，格式：yyyy-MM-dd HH:mm:ss。 |
| status | String | 用户状态：<br>1：正常<br>2：注销<br>3：未激活<br>4：禁用 |
| String | 邮箱地址。 | |
| phone | String | 手机号码。 |
| userid | String | 调用方用于标示用户的唯一 ID（例如企业用户可以为企业账户英文名、个人用户可以为手机号等）。 |
| uuid | String | 用户身份 ID（腾讯会议颁发的用于开放平台的唯一用户 ID）。 |
| area | String | 地区编码（国内默认86）。 |
| staff_id | String | 员工工号。 |
| job_title | String | 员工职位。 |
| entry_time | String | 入职时间。 |
| role_name | String | 角色名称。 |
| role_code | String | 角色类型。 |
| department_list | 部门信息对象数组 | 用户部门信息。 |
部门对象
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| department_id | String | 部门 ID。 |
| department_name | String | 部门名称。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/users/9527
输出示例
{
"area": "86",
"update_time": "2020-04-21 18:01:29",
"phone": "13000000000",
"userid": "9527",
"email": "",
"username": "testusername",
"status": "1",
"uuid": "WM4Fs4Th56ogU13JiK"，
"job_title": "developer",
"staff_id": "6666",
"entry_time": "2021-08-09",
"role_name": "普通成员",
"role_code": "NORMAL_ROLE",
"department_list": [{
"department_id": "e3ce****************4de921fc2c2d",
"department_name": "主部门"
}]
}
下载 腾讯会议API用户管理-通过 userid 获取用户详情-腾讯会议.pdf
文章内容是否对您有帮助？
有帮助
无帮助
能否告知我们这篇文章的问题？（选填）