查询用户管理的邮件组

通过接口查询用户管理的邮件组

请求

基本
HTTP URL	https://hi-gw.weizhipin.com/open-apis/mail/v1/mailgroups/:user_id/managed_groups
HTTP Method	GET
支持的应用类型	自建应用
权限要求	[邮箱]-[创建/更改/查询邮件组]

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560"
Content-Type	string	是	固定值："application/json; charset=utf-8"

路径参数（url中冒号标识的参数,如":xxxx"请连同:整体替换成对应值）

名称	类型	描述
user_id	string	用户id 被查询用户，需要与查询参数中的user_id_type类型保持一致

查询参数（url后?&拼接的参数）

名称	类型	描述
user_id_type	string	控制响应体内返回的用户 ID 的类型示例值："open_id" 可选值有： open_id：用户的 open id union_id：用户的 union id user_id：用户的 user id 默认值：open_id 当值为 user_id时，存在字段权限要求，未开通则会调用失败： 请参见[应用权限管理]-[通讯录]- [获取用户ID]
page_token	string	分页标记 第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token
page_size	int	分页大小 默认20 可填写1-100个/页
page_num	int	指定第几页进行查询

响应

响应体

{
  "code": "0",
  "traceId": "",
  "data": {
      "has_more": true, //示例值
      "page_token": "qwerasdfzxcv", //示例值
      "page_num": 1, //示例值
      "page_size": 20, //示例值
      "total": 100, //示例值
      "items": [{ //示例值
          "name": "xxx",
          "email": "xxx@example.com",
          "description": "邮件组说明"
      }]
  },
  "msg": "操作成功"
}

data内对象结构

名称	类型	描述
has_more	boolean	是否还有更多项
page_token	string	分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token
page_num	int	当前所在的页码
total	int	总匹配的记录条数
items	array	邮件组成员列表
∟name	string	邮件组名称
∟email	string	邮件组地址
∟description	string	邮件组说明

如果响应非成功状态，请对照 错误码文档