日志与导出
查找任意一封邮件或 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 请求日志中移除该地址。