跳到内容
Esc
↑↓导航↵打开⌘J预览
本页内容

日志与导出

查找任意一封邮件或 API 请求,了解它经历了什么,并把你的数据下载为 CSV。

有三个工具可以帮你回答「这封邮件发生了什么?」:邮件列表、API 请求日志和 CSV 导出。

邮件

在控制台中,邮件 页面列出你的团队发送的每一封邮件。可以按收件人、主题或邮件 ID 搜索,也可以按状态、API 密钥、品牌(发信域名)、来源(事务邮件或群发)和时间范围筛选。

打开一封邮件可以看到:

  • 按顺序排列的事件:已发送、已送达、已延迟、已退信、已打开、已点击等,以及延迟或退信的原因;
  • 邮件发出时的内容(预览、HTML 或纯文本)和邮件头;
  • 对尚未发出的邮件,显示它在等待的原因(套餐限制、预热、安全检查等);
  • 它的 送达率洞察 评分。

通过 API,GET /emails 列出邮件(最新的在前,使用游标分页),GET /emails/{id} 返回一封邮件及其最新事件。两者都需要完全访问权限的 API 密钥。想在事件发生时就收到推送,请使用 Webhook。

所有套餐的邮件正文和历史记录都保存 30 天,之后删除。

API 请求日志

控制台中的 日志 页面列出最近 30 天内,用你的 API 密钥或通过 MCP 发出的每一个请求。每行显示状态、方法、路径、发出请求的密钥或已连接的应用,以及时间。

  • 可以按路径、密钥或请求 ID 搜索。可以按来源(API 密钥或 MCP)、API 密钥、状态类别(2xx、4xx、5xx)和时间范围筛选。
  • 打开一行可以查看请求和响应的内容,方便查明某次调用为什么返回 422 或 403。
  • 只有 JSON 格式且小于 64 KB 的内容才会被保存。邮件内容(html、text)会被替换为它的大小,令牌、密码等机密信息显示为 [redacted],请求头从不保存。
  • 只有所有者、管理员和开发者能看到内容。

导出为 CSV

列出你的数据的页面都有 导出 CSV 按钮。文件带有你已应用的筛选条件,所以和屏幕上显示的内容一致。一次导出最多包含 50,000 行,最新的在前。导出使用你的控制台登录身份,所以没有对应的 API 接口。

可以导出什么取决于你的 团队角色:

导出内容 位置 角色
联系人、退订、群发收件人 联系人页面,以及群发自己的页面 所有者、管理员、营销
域名、API 密钥、API 请求日志 各自的页面 所有者、管理员、开发者
邮件、抑制列表、审计日志 邮件、联系人 → 抑制列表、设置 所有者、管理员

请求日志导出的列有 request_id、created_at、method、path、status、duration_ms 和 caller。联系人导出包含 unsubscribed 列和 unsubscribed_domains 列(* 表示整个团队)。

删除某个人的数据

要从历史记录中移除某位收件人,请带上 erase: true 删除该联系人,详见 联系人。这也会从邮件历史、事件载荷和 API 请求日志中移除该地址。

这个页面有帮助吗?