Penyerapan dan Pengiriman Email
Fitur penyerapan dan pengiriman email menentukan cara pengguna yang masuk dengan kredensial tersimpan menyinkronkan email masuk dan antrean pengiriman keluar. Ini memberi Anda satu urutan penggunaan yang jelas: masuk, setel kredensial, lalu jalankan operasi IMAP dan SMTP.
Mengapa Ini Penting
Fitur ini menyimpan data email penyedia dalam bentuk akun yang konsisten sehingga pembacaan dan penulisan tetap dapat diprediksi di seluruh alur IMAP dan SMTP. Ini memisahkan pencarian metadata dari pengambilan seluruh isi dan bagian, dan menghubungkan tindakan penyedia dengan tugas dan tugas untuk perilaku percobaan ulang yang jelas.
Aliran Inti
Setelah masuk, klien menggunakan kredensial yang disimpan untuk menyinkronkan kotak surat atau pesan dari IMAP. Inbox Manager menyimpan pesan dan data bagian, klien mencari dan membaca apa yang mereka butuhkan, dan pengiriman SMTP keluar diantrekan sementara hasilnya dilacak melalui tugas, pekerjaan, dan log.
Operasi
| Operasi | Endpoint | Tujuan |
|---|---|---|
| Sinkronkan kotak surat | POST /api/accounts/:account_id/imap/sync-mailboxes | Enqueue sinkronisasi kotak surat |
| Sinkronkan pesan | POST /api/accounts/:account_id/imap/sync-messages | Enqueue sinkronisasi pesan |
| Kirim pesan SMTP | POST /api/accounts/:account_id/smtp/messages | Enqueue pengiriman pesan keluar |
| Daftar email | GET /api/accounts/:account_id/emails | Cantumkan metadata email akun |
| Cari email | POST /api/accounts/:account_id/emails/search | Kueri email berdasarkan bidang yang diindeks |
| Hapus email dengan pencarian | POST /api/accounts/:account_id/emails/search-delete | Hapus secara massal catatan email yang cocok |
| Buat catatan email | POST /api/accounts/:account_id/emails | Buat catatan email secara eksplisit |
| Dapatkan email | GET /api/emails/:email_id | Ambil satu catatan email |
| Perbarui email | PATCH /api/emails/:email_id | Perbarui bidang email yang dapat diubah |
| Hapus email | DELETE /api/emails/:email_id | Hapus satu catatan email |
| Dapatkan seluruh tubuh | GET /api/accounts/:account_id/emails/:email_id/body | Ambil isi pesan yang diurai |
| Daftar bagian | GET /api/accounts/:account_id/emails/:email_id/parts | Ambil metadata bagian pesan |
| Dapatkan konten bagian | GET /api/accounts/:account_id/emails/:email_id/parts/:part_id/content | Ambil konten yang didekodekan untuk satu bagian |
Data dan Status Utama
| Barang | Tujuan | Tertaut Ke |
|---|---|---|
email_message | Data pesan masuk/keluar yang disimpan | task, job, kredensial penyedia |
email_message_part | Bagian data untuk lampiran dan penyematan | email_message |
email_message_part_content | Muatan bagian yang didekodekan | email_message_part |
task | Operasi penyedia yang diminta | job |
Mode dan Kontrol Kegagalan
Kegagalan sinkronisasi atau pengiriman dari provider muncul melalui status task/job dan audit trail, bukan secara diam-diam. Rute cakupan akun menolak ketidakcocokan akun, penghapusan pencarian tetap eksplisit dan tercakup, dan pengambilan isi atau bagian konten tetap berada di endpoint khusus untuk mencegah pengambilan berlebihan yang tidak disengaja selama operasi daftar atau pencarian.
Terkait
Pesan Email, Bagian Pesan Email, Isi Bagian Pesan Email, Tugas, Panduan Sinkronisasi IMAP, Panduan Telusuri dan Baca, Panduan Kirim Email Keluar.