Skip to main content
GET
Inboxes - Query Metrics
返回与 get_agentmail_metrics 相同的聚合计数,但范围是单个收件箱:「计数名 → 数据点数组」的扁平映射,键为 message.received、message.received.spam、message.received.blocked、message.received.unauthenticated、message.sent、message.delivered、message.bounced、message.complained、message.rejected、message.opened 和 domain.verified。空数组表示没有活动,不是错误。该结构未在本 spec 中固定,请读实际返回的键。要逐条事件用 get_agentmail_inbox_events;要账号级总计用 get_agentmail_metrics。

示例

第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

费用与请求规则

公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.012
  • 计费依据: explicit_zero
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

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

路径参数

inbox_id
string
必填

收件箱的 ID。

查询参数

descending
boolean

按降序排序。

end
string<date-time>

查询的结束时间戳。

event_types
enum<string>[]

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

指标事件的类型。

可用选项:
message.sent,
message.delivered,
message.bounced,
message.delayed,
message.rejected,
message.complained,
message.received
limit
integer

返回的桶数量上限。

period
string

查询周期,以秒为单位。

start
string<date-time>

查询的开始时间戳。

响应

状态码为 200 的响应

按事件类型分组的指标。

{key}
MetricBucket · object[]