---
title: 日誌與匯出
description: 找出任何一封 Email 或 API 請求、查看發生了什麼事，並把資料下載成 CSV。
ai:
  exclude: true
---

有三個工具可以幫你回答「這件事後來怎麼了」：Email 清單、API 請求日誌，以及 CSV 匯出。

## 郵件

在控制台的**郵件**頁面會列出團隊寄出的每一封 Email。可以用收件者、主旨或 Email ID 搜尋，並依狀態、API 金鑰、品牌（寄件網域）、來源（交易郵件或群發）與時間範圍篩選。

打開一封 Email 可以看到：

- 依序列出的事件：已寄出、已送達、延遲、退信、開信、點擊等，並附上延遲或退信的原因；
- 寄出時的內容（預覽、HTML 或純文字）與標頭；
- 尚未寄出的 Email 為什麼在等待（方案限制、預熱、安全檢查等）；
- 它的[送達率洞察](/docs/zh-hant/concepts/deliverability-insights)分數。

透過 API，`GET /emails` 會列出 Email（最新的在前，採用游標分頁），`GET /emails/{id}` 會回傳單封 Email 與它的最後事件。兩者都需要具備完整權限的 API 金鑰。想在事件發生時就收到推送，請使用 [Webhook](/docs/zh-hant/concepts/webhooks)。

所有方案的 Email 內文與歷史記錄都保存 30 天，之後會移除。

## API 請求日誌

控制台的**日誌**會列出最近 30 天內，使用你的 API 金鑰或透過 MCP 發出的每一個請求。每一列顯示狀態、方法、路徑、發出請求的金鑰或已連接的應用程式，以及時間。

- 可依路徑、金鑰或請求 ID 搜尋。可依來源（API 金鑰或 MCP）、API 金鑰、狀態類別（`2xx`、`4xx`、`5xx`）與時間範圍篩選。
- 打開一列可以看到請求與回應的內文，幫助你找出呼叫為什麼回傳 `422` 或 `403`。
- 內文只在是 JSON 且小於 64 KB 時才會儲存。Email 內容（`html`、`text`）會以大小取代，權杖與密碼這類機密會顯示為 `[redacted]`，標頭則完全不儲存。
- 只有擁有者、管理員與開發者看得到內文。

## 匯出成 CSV

列出你資料的頁面都有**匯出 CSV** 按鈕。檔案會帶入你套用的篩選條件，因此與畫面上看到的一致。一次匯出最多 50,000 列，最新的在前。匯出使用你的控制台登入身分，所以沒有對應的 API 端點。

能匯出什麼取決於你的[團隊角色](/docs/zh-hant/team-roles)：

| 匯出項目 | 位置 | 角色 |
| --- | --- | --- |
| 聯絡人、退訂、群發收件者 | 聯絡人頁面，以及群發的頁面 | 擁有者、管理員、行銷 |
| 網域、API 金鑰、API 請求日誌 | 各自的頁面 | 擁有者、管理員、開發者 |
| 郵件、抑制清單、稽核日誌 | 郵件、聯絡人 → 抑制清單、設定 | 擁有者、管理員 |

請求日誌的匯出檔有 `request_id`、`created_at`、`method`、`path`、`status`、`duration_ms` 與 `caller` 欄位。聯絡人的匯出檔包含 `unsubscribed` 欄與 `unsubscribed_domains` 欄（`*` 代表整個團隊）。

## 清除個人資料

要從歷史記錄中移除某位收件者，請依[聯絡人](/docs/zh-hant/concepts/contacts)的說明，用 `erase: true` 刪除該聯絡人。這也會從 Email 歷史記錄、事件內容與 API 請求日誌中移除該位址。
