งาน
คุณลักษณะงานจะกำหนดการร้องขอการทำงานของผู้ให้บริการระดับความตั้งใจก่อนที่การดำเนินการจะเข้าสู่คิว โดยให้การควบคุมการเรียบเรียงอย่างชัดเจน เพื่อให้สามารถสร้าง ตรวจสอบ และเรียกใช้การดำเนินการในกล่องจดหมายตามที่กำหนดได้
ทำไมเรื่องนี้ถึงสำคัญ
คุณลักษณะนี้จะแยกจุดประสงค์ทางธุรกิจออกจากรายละเอียดการดำเนินการคิวโดยทำให้บันทึกงานเป็นแหล่งที่มาของความจริงสำหรับงานที่ร้องขอ รองรับการทริกเกอร์และการตรวจสอบอย่างชัดเจนก่อนที่จะกระจายงาน ซึ่งช่วยให้การควบคุมผู้ปฏิบัติงานชัดเจนเมื่อระบบอัตโนมัติต้องการการแทรกแซง
คอร์โฟลว์
ไคลเอนต์สร้างงานด้วยประเภท เป้าหมาย และเพย์โหลด จากนั้นใช้บันทึกนั้นเป็นความตั้งใจในการดำเนินการ เมื่อทริกเกอร์ งานคิวจะถูกสร้างขึ้นจากงาน และการอ่านที่ตามมาจะสะท้อนถึงสถานะของงานและผลลัพธ์ของงานที่เชื่อมโยง
การดำเนินงาน
| การดำเนินงาน | จุดสิ้นสุด | วัตถุประสงค์ |
|---|---|---|
| สร้างงาน | POST /api/accounts/:account_id/tasks | ลงทะเบียนจุดประสงค์งานขอบเขตบัญชีใหม่ |
| รายการงาน | GET /api/accounts/:account_id/tasks | ดึงไทม์ไลน์งานสำหรับบัญชี |
| ค้นหางาน | POST /api/accounts/:account_id/tasks/search | ค้นหางานตามตัวกรองประเภท/สถานะ |
| รับงาน | GET /api/tasks/:task_id | ดึงข้อมูลหนึ่งงาน |
| อัพเดทงาน | PATCH /api/tasks/:task_id | แก้ไขฟิลด์งานที่ไม่แน่นอน |
| ลบงาน | DELETE /api/tasks/:task_id | ลบงาน |
| งานทริกเกอร์ | POST /api/tasks/:task_id/trigger | เริ่มหรือรีสตาร์ทการดำเนินการจากงาน |
ข้อมูลสำคัญและสถานะ
{
id: "tsk_...",
account_id: "acc_...",
task_type: "imap_sync_messages",
target_credential_id: "pc_...",
payload: { folder: "INBOX" },
priority: 0
}โหมดความล้มเหลวและการควบคุม
เพย์โหลดงานที่ไม่ถูกต้องหรือการอ้างอิงเป้าหมายจะถูกปฏิเสธก่อนที่จะเริ่มดำเนินการคิว การดำเนินการทริกเกอร์นั้นชัดเจนและกำหนดขอบเขตงาน การตรวจสอบการเข้าถึงบัญชีจะใช้เพื่อสร้าง/อ่าน/เปลี่ยนแปลงขอบเขต และการลบงานจะไม่เกิดขึ้นเนื่องจากผลข้างเคียงของการล้างข้อมูลงานที่ไม่เกี่ยวข้อง