获取收件箱邮件列表 - 企业微信 API

由于用户可向应用所绑定的邮箱回复邮件，故支持应用获取应用收件箱的邮件列表。
该接口用于分页获取收件箱下，指定时间范围内的邮件id列表。

权限说明

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

第三方应用需具有“邮件”权限

代开发自建应用需具有“邮件”权限

curl --location --request POST 'https://qyapi.weixin.qq.com/cgi-bin/exmail/app/get_mail_list' \ --header 'Content-Type: application/json' \ --data-raw '{ "begin_time": 1668441600, "end_time": 1668527999, "cursor": "CURSOR", "limit": 100 }'

请求参数

Query 参数

access_token

string

调用接口凭证

可选

示例值:

ACCESS_TOKEN

Body 参数application/json

begin_time

integer

必需

开始时间，unix时间戳

end_time

integer

必需

结束时间，unix时间戳

cursor

string

可选

上一次调用时返回的next_cursor，第一次拉取可以不填

limit

integer

可选

期望请求的数据量，默认值为100，最大值为1000

示例

返回响应

🟢200成功

application/json

Body

errcode

integer

返回码

必需

errmsg

string

必需

对返回码的文本描述内容

next_cursor

string

必需

应用邮箱帐号中邮件未读数

has_more

integer

必需

是否还有更多数据。0-没有 1-有

mail_list

array [object {1}]

邮件列表

必需

mail_id

string

可选