電子郵件擷取與傳送
電子郵件接收和傳送功能定義具有已儲存憑證的登入使用者如何同步入站電子郵件和對出站發送進行排隊。 它為您提供了一個明確的使用順序：登入、設定憑證，然後執行 IMAP 和 SMTP 操作。
為什麼這很重要
此功能以一致的帳戶形式儲存提供者電子郵件數據，因此跨 IMAP 和 SMTP 流的讀取和寫入保持可預測。它將元資料搜尋與全身和局部檢索分開，並將提供者操作與任務和作業聯繫起來，以實現清晰的重試行為。
核心流程
登入後，用戶端使用已儲存的憑證來同步來自 IMAP 的郵箱或訊息。收件匣管理器儲存訊息和部分數據，客戶端搜尋並讀取所需內容，出站 SMTP 發送排隊，同時透過任務、作業和日誌追蹤結果。
操作
| 營運 | 端點 | 目的 |
|---|---|---|
| 同步信箱 | POST /api/accounts/:account_id/imap/sync-mailboxes | 入隊信箱同步 |
| 同步訊息 | POST /api/accounts/:account_id/imap/sync-messages | 入隊訊息同步 |
| 傳送 SMTP 訊息 | POST /api/accounts/:account_id/smtp/messages | 將出站訊息傳送入隊 |
| 列出電子郵件 | GET /api/accounts/:account_id/emails | 列出帳戶電子郵件元資料 |
| 搜尋電子郵件 | POST /api/accounts/:account_id/emails/search | 依索引欄位查詢電子郵件 |
| 透過搜尋刪除電子郵件 | POST /api/accounts/:account_id/emails/search-delete | 批次刪除符合的電子郵件記錄 |
| 建立電子郵件記錄 | POST /api/accounts/:account_id/emails | 明確建立電子郵件記錄 |
| 取得電子郵件 | GET /api/emails/:email_id | 檢索一封電子郵件記錄 |
| 更新電子郵件 | PATCH /api/emails/:email_id | 更新可變電子郵件欄位 |
| 刪除電子郵件 | DELETE /api/emails/:email_id | 刪除一封電子郵件記錄 |
| 取得全身 | GET /api/accounts/:account_id/emails/:email_id/body | 檢索已解析的訊息內文 |
| 列出零件 | GET /api/accounts/:account_id/emails/:email_id/parts | 檢索訊息部分元資料 |
| 取得部分內容 | GET /api/accounts/:account_id/emails/:email_id/parts/:part_id/content | 檢索一部分的解碼內容 |
關鍵數據和狀態|專案 |目的|連結到 |
| ---------------------------- | ------------------------------------------------ |-------------------------------- |
| email_message |儲存的入站/出站訊息資料 | task、job、提供者憑證 |
| email_message_part |附件和嵌入件的零件資料 | email_message |
| email_message_part_content |解碼部分有效負載 | email_message_part |
| task |請求的提供者操作 | job |
故障模式與控制
提供者同步或發送失敗是透過任務/作業狀態和審核追蹤而不是靜默丟棄來顯示的。帳戶範圍的路由拒絕帳戶不匹配，搜尋刪除保持明確和範圍，正文或部分內容檢索保留在專用端點上，以防止在清單或搜尋操作期間意外過度獲取。
相關
電子郵件訊息、電子郵件訊息部分、電子郵件訊息部分內容、任務、IMAP 同步指南、[搜尋和閱讀指南]發送指南、URL_5@URL_6@2@UR_6.