การนำเข้าและส่งอีเมล
คุณลักษณะการนำเข้าและส่งอีเมลจะกำหนดวิธีที่ผู้ใช้ที่ลงชื่อเข้าใช้ด้วยข้อมูลประจำตัวที่บันทึกไว้จะซิงค์อีเมลขาเข้าและคิวการส่งขาออก โดยให้ลำดับการใช้งานที่ชัดเจนแก่คุณ: ลงชื่อเข้าใช้ ตั้งค่าข้อมูลรับรอง จากนั้นเรียกใช้การดำเนินการ IMAP และ SMTP
ทำไมเรื่องนี้ถึงสำคัญ
คุณลักษณะนี้จัดเก็บข้อมูลอีเมลของผู้ให้บริการในรูปแบบบัญชีที่สอดคล้องกัน ดังนั้นการอ่านและเขียนจึงสามารถคาดเดาได้ตลอดโฟลว์ IMAP และ SMTP โดยแยกการค้นหาข้อมูลเมตาออกจากการดึงข้อมูลแบบเต็มและบางส่วน และเชื่อมโยงการดำเนินการของผู้ให้บริการกับงานและงานเพื่อให้เกิดพฤติกรรมการลองใหม่ที่ชัดเจน
คอร์โฟลว์
หลังจากลงชื่อเข้าใช้ ไคลเอ็นต์จะใช้ข้อมูลประจำตัวที่บันทึกไว้เพื่อซิงค์กล่องจดหมายหรือข้อความจาก IMAP Inbox Manager จะจัดเก็บข้อความและข้อมูลชิ้นส่วน ไคลเอนต์ค้นหาและอ่านสิ่งที่ต้องการ และการส่ง 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, คำแนะนำการค้นหาและอ่าน, ส่งอีเมลคำแนะนำขาออก