批量获取邮件组权限成员

分页批量获取邮件组权限成员列表

curl --location --request GET 'https://open.feishu.cn/open-apis/mail/v1/mailgroups/"xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx"/permission_members?user_id_type=open_id&department_id_type=open_department_id&page_token=xxx&page_size=10' \ --header 'Authorization;'

{ "code": 0, "msg": "success", "data": { "has_more": true, "page_token": "xxx", "items": [ { "permission_member_id": "xxxxxxxxxxxxxxx", "user_id": "xxxxxxxxxx", "department_id": "xxxxxxxxxx", "type": "USER" } ] } }

请求参数

Path 参数

mailgroup_id

必需

邮件组ID或者邮件组地址示例值："xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx"

示例值:

"xxxxxxxxxxxxxxx 或 test_mail_group@xxx.xx"

Query 参数

user_id_type

必需

用户 ID 类型示例值："open_id" 可选值有： open_id：用户的 open id union_id：用户的 union id user_id：用户的 user id 默认值：open_id 当值为 user_id，字段权限要求：获取用户 user ID

示例值:

open_id

department_id_type

必需

此次调用中使用的部门ID的类型示例值："open_department_id" 可选值有： department_id：以自定义department_id来标识部门 open_department_id：以open_department_id来标识部门

示例值:

open_department_id

page_token

必需

分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果示例值："xxx"

示例值:

xxx

page_size

必需

分页大小示例值：10 数据校验规则：最大值：200

示例值:

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

返回响应

🟢200200 Success

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

has_more

boolean

是否还有更多项

必需

page_token

string

必需

分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token

items

array [object {4}]

邮件组权限成员列表

必需