# 查询用户所属用户组

通过该接口可查询该用户所属的用户组列表。如果应用的通讯录权限范围是“全部员工”,则可获取该员工所属的全部用户组列表。

# 请求

基本
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
最后更新于 : 8/21/2023, 4:57:10 PM