Skip to content

获取公共邮箱成员列表

适用版本>=v7.0.2601.20260122

接口说明:获取公共邮箱成员列表

标签公共邮箱

请求说明

字段
请求地址
配置域名+/openapi+/v7/public_mailboxes/{public_mailbox_id}/members
HTTP 方法
GET
接口描述
获取公共邮箱成员列表
签名方式
KSO-1(配置域名+/openapi不参与签名)
限频策略
权限要求
查询公共邮箱(应用授权) kso.public_mailbox.read
查询和管理公共邮箱(应用授权) kso.public_mailbox.readwrite

请求头 (Headers)

属性名类型是否必填描述可选值
X-Kso-Id-Type
string类型
* internal - 内部
* external - 外部
internal, external
X-Kso-Date
stringRFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT-
X-Kso-Authorization
stringKSO-1 签名值,详见《签名方法》-
Authorization
string授权凭证,格式为:Bearer {access_token}-

路径参数 (Path)

属性名类型是否必填描述可选值
public_mailbox_id
string公共邮箱唯一标识-

查询参数 (Query)

属性名类型是否必填描述可选值
page_size
integer分页大小-
page_token
string翻页token,首次无需提供-
with_total
boolean是否返回total字段,默认不返回-

响应体(Response)

HTTP状态码: 200
响应体格式: application/json

没有可用的数据

响应体示例

json
{
  "data": {
    "items": [
      {
        "member_id": "string",
        "name": "string",
        "object_id": "string",
        "object_type": "department",
        "permission": "send_only"
      }
    ],
    "next_page_token": "string",
    "total": 0
  },
  "code": 0,
  "msg": "string"
}