電子メールの取り込みと配信
電子メールの取り込みおよび配信機能は、保存された資格情報を持つサインイン ユーザーが受信電子メールを同期し、送信送信をキューに入れる方法を定義します。 これにより、サインイン、資格情報の設定、IMAP および SMTP 操作の実行という、明確な使用順序が 1 つ与えられます。
なぜこれが重要なのか
この機能はプロバイダーの電子メール データを一貫したアカウント形式で保存するため、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 | 1 つの電子メール レコードを取得する |
| 更新メール | PATCH /api/emails/:email_id | 変更可能な電子メールフィールドを更新する |
| メールを削除 | DELETE /api/emails/:email_id | 1 件の電子メール レコードを削除する |
| 全身を手に入れる | 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 | 1 つのパートのデコードされたコンテンツを取得する |
主要なデータと状態|アイテム |目的 |リンク先 |
| ---------------------------- | ------------------------------------ | ---------------------------------- |
| email_message |保存された受信/送信メッセージ データ | task、job、プロバイダーの資格情報 |
| email_message_part |アタッチメントおよび埋め込み用の部品データ | email_message |
| email_message_part_content |デコードされた部分ペイロード | email_message_part |
| task |要求されたプロバイダーの操作 | job |
故障モードと制御
プロバイダーの同期または送信の失敗は、サイレント ドロップではなく、タスク/ジョブの状態と監査証跡を通じて表面化されます。アカウント スコープのルートはアカウントの不一致を拒否し、検索削除は明示的かつ範囲指定されたままであり、本文または部分コンテンツの取得は専用エンドポイントに留まり、リストまたは検索操作中の偶発的なオーバーフェッチを防ぎます。
関連
電子メール メッセージ、電子メール メッセージ部分、電子メール メッセージ部分の内容、タスク、IMAP 同期ガイド、検索と読み取りガイド、送信メール ガイドの送信。