腾讯会议
有奖捉虫：办公协同&微信生态&物联网文档专题 HOT
文档中心 > 腾讯会议 > 开放平台文档 > 服务端 API > REST APIs > 用户管理 > 获取用户详情

获取用户详情

最近更新时间：2024-03-15 10:15:22

我的收藏

本页目录：

通过 userid 获取用户详情

接口描述

描述：使用 userid 获取企业用户详情。企业 secret 鉴权用户可获取该用户所属企业下的用户详情，暂不支持 OAuth2.0 鉴权用户通过 userid 查询用户详情。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/users/{userid}

输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
userid
是
String
调用方用于标示用户的唯一 ID（企业内部请使用企业唯一用户标识）。
企业唯一用户标识说明：
1：企业对接 SSO 时使用的员工唯一标识 ID。
2：企业调用创建用户接口时传递的 userid 参数。

输出参数

参数名称
参数类型
参数描述
username
String
用户昵称。
update_time
String
更新时间，格式：yyyy-MM-dd HH:mm:ss。
status
String
用户状态：
1：正常
2：注销
3：未激活
4：禁用
email
String
邮箱地址。
avatar_url
String
头像地址。
account_type
Integer
0：个人免费版
5：由企业微信创建的企业
其他值均为会议付费版本。
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
部门信息对象数组
用户部门信息。
account_version
Integer
账号版本。 0：其他 1：商业版 2：企业版 3：教育版
user_account_type
Integer
账号类型。 1：高级账号（企业版/教育版） 2：免费账号（企业版/教育版） 3：免费账号100方 （商业版） 4：高级账号300方（商业版） 5：高级账号500方（商业版） 6：高级账号1000方（商业版） 7：高级账号2000方（商业版） 8：高级账号100方（商业版）

部门对象

参数名称
参数类型
参数描述
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",
    "account_version":2,
    "user_account_type":1,
    "department_list": [{
        "department_id": "e3ce****************4de921fc2c2d",
        "department_name": "主部门"
    }]
}

通过 uuid 获取用户详情

接口描述

描述：使用 uuid 获取企业用户详情。企业 secret 鉴权用户可获取该用户所属企业下的用户详情，暂不支持 OAuth2.0 鉴权访问。
请求方式：GET
接口请求域名：
https://api.meeting.qq.com/v1/users?uuid={uuid}

输入参数

以下请求参数列表仅列出了接口请求参数，HTTP 请求头公共参数请参见签名验证章节的 公共参数说明。
参数名称
必选
参数类型
参数描述
uuid
是
String
用户身份 ID（腾讯会议颁发的用于开放平台的唯一用户 ID）。

输出参数

参数名称
参数类型
参数描述
username
String
用户昵称。
update_time
String
更新时间，格式：yyyy-MM-dd HH:mm:ss。
status
String
用户状态：
1：正常
2：注销
3：未激活
4：禁用
email
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?uuid=WM4Fs4Th56ogU13JiK

输出示例

{
    "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": "e3ce085****************921fc2c2d",
        "department_name": "主部门"
    }]
}


中国站