Skip to main content
GET
查询账号指标
返回整个账号的聚合计数,结构是「计数名 → 数据点数组」的扁平映射。2026-08-24 实测的键为 message.receivedmessage.received.spammessage.received.blockedmessage.received.unauthenticatedmessage.sentmessage.deliveredmessage.bouncedmessage.complainedmessage.rejectedmessage.openeddomain.verified,在无流量的账号上每个都是空数组——空数组表示没有活动,不是错误。该结构未在本 spec 中固定,请读实际返回的键,别假设这份清单是封闭的。这是账号级视图,跨越账号下的每一个收件箱。所有 AIsa 调用方共用同一个 AgentMail 账号,因此这里会触及其他调用方创建的收件箱;只针对单个收件箱时请用收件箱级的孪生工具 get_agentmail_inbox_metrics

示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

Authorization
string
必填

Bearer 身份验证

查询参数

event_types
enum<string>[]

要查询的指标事件类型列表。

指标事件的类型。

可用选项:
message.sent,
message.delivered,
message.bounced,
message.delayed,
message.rejected,
message.complained,
message.received
start
string<date-time>

查询的开始时间戳。

end
string<date-time>

查询的结束时间戳。

period
string

查询周期,以秒为单位。

limit
integer

返回的桶数量上限。

descending
boolean

按降序排序。

响应

状态码为 200 的响应

按事件类型分组的指标。

{key}
MetricBucket · object[]