获取业务邮箱详情 - 接口文档 - 企业微信开发者中心

开发者中心

首页

教程

接口

社区

工具

企业内部开发

快速入门服务端API 客户端API 附录更新日志联系我们

企业内部开发服务端API 邮件管理业务邮箱获取业务邮箱详情

获取业务邮箱详情

最后更新：2022/12/01

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

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/exmail/publicmail/get?access_token=ACCESS_TOKEN

请求包体

{
  "id_list": [1, 2]
}

参数说明

参数	类型	是否必须	说明
id_list	uint32	是	业务邮箱ID列表

权限说明

自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）
应用调用接口只能访问自身创建的业务邮箱

返回示例

{
  "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
      ]
    }
  }]
}

参数说明

参数	类型	说明
errcode	int32	错误码
errmsg	string	错误码说明
id	uint32	业务邮箱ID
email	string	业务邮箱地址
name	string	业务邮箱名称
userid_list	string	有权限使用业务邮箱的成员UserID列表
department_list	uint32	有权限使用业务邮箱的部门列表
tag_list	uint32	有权限使用业务邮箱的标签列表

删除业务邮箱

模糊搜索业务邮箱

本节内容

获取业务邮箱详情