# 查询用户所属用户组
通过该接口可查询该用户所属的用户组列表。如果应用的通讯录权限范围是“全部员工”,则可获取该员工所属的全部用户组列表。
# 请求
基本 | |
---|---|
HTTP URL | https://hi-gw.weizhipin.com/open-apis/contact/group/member_belong |
HTTP Method | GET |
支持的应用类型 | 自建应用 |
权限要求 | 获取用户组信息 |
# 请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token "示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" |
# 查询参数
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
member_id | string | 是 | 成员ID 示例值:"u287xj12" |
member_id_type | string | 否 | 成员ID类型 示例值:"open_id" 可选值有: * open_id :member_id_type为user时,表示用户的open_id* union_id :member_id_type为user时,表示用户的union_id* user_id :member_id_type为user时,表示用户的user_id默认值: open_id |
# 响应
# 响应体
名称 | 类型 | 描述 |
---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | group[] | 用户组ID列表 |
group_id | string | 用户组Id |
name | string | 用户组名称 |
# 响应体示例
{
"code": 0,
"traceId": "_Ao59UOIBLPCeAAu",
"data": [
{
"group_id": "asdasd112",
"name": "开放平台用户组01"
},
{
"group_id": "zloKKu33NBzg1NjW2",
"name": "开放平台用户组01"
}
],
"msg": "操作成功"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
2
3
4
5
6
7
8
9
10
11
12
13
14
15