获取业务邮箱详情

POST

https://qyapi.weixin.qq.com/cgi-bin/exmail/publicmail/get

该接口用于获取业务邮箱详细信息，包含业务邮箱名称、权限信息。

权限说明

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）

应用调用接口只能访问自身创建的业务邮箱

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/exmail/publicmail/get' \
--header 'Content-Type: application/json' \
--data-raw '{
  "id_list": [1, 2]
}'

响应示例

{
    "errcode": 0,
    "errmsg": "ok",
    "list": [
        {
            "id": 1,
            "email": "apitest3@gzdev.com",
            "name": "测试",
            "userid_list": {
                "list": [
                    "member",
                    "member2"
                ]
            },
            "department_list": {
                "list": [
                    1,
                    2
                ]
            },
            "tag_list": {
                "list": [
                    1,
                    2
                ]
            }
        }
    ]
}

请求参数

Query 参数

access_token

string

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

id_list

array[integer]

业务邮箱ID列表

必需

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

错误码

必需

errmsg

string

错误码说明

必需

list

array [object {6}]

必需

integer

业务邮箱ID

可选

string

业务邮箱地址

可选

name

string

业务邮箱名称

可选

userid_list

object

可选

有权限使用业务邮箱的成员UserID列表

department_list

object

可选

有权限使用业务邮箱的部门列表

tag_list

object

可选

有权限使用业务邮箱的标签列表

删除业务邮箱

模糊搜索业务邮箱