Tugas
Fitur tugas menentukan permintaan kerja penyedia tingkat maksud sebelum eksekusi memasuki antrean. Ini memberi Anda kontrol orkestrasi eksplisit sehingga operasi kotak masuk dapat dibuat, diperiksa, dan dipicu secara deterministik.
Mengapa Ini Penting
Fitur ini memisahkan maksud bisnis dari detail eksekusi antrean dengan menjadikan rekaman tugas sebagai sumber kebenaran untuk pekerjaan yang diminta. Teknologi ini mendukung pemicuan dan kemampuan audit yang jelas sebelum pekerjaan didistribusikan, sehingga kontrol operator tetap jelas ketika otomatisasi memerlukan intervensi.
Aliran Inti
Klien membuat tugas dengan tipe, target, dan payload, lalu menggunakan rekaman tersebut sebagai maksud kanonik untuk dieksekusi. Ketika dipicu, pekerjaan antrean dibuat dari tugas dan pembacaan berikutnya mencerminkan status tugas dan hasil pekerjaan yang terkait.
Operasi
| Operasi | Endpoint | Tujuan |
|---|---|---|
| Buat tugas | POST /api/accounts/:account_id/tasks | Daftarkan maksud tugas cakupan akun baru |
| Daftar tugas | GET /api/accounts/:account_id/tasks | Ambil garis waktu tugas untuk akun |
| Tugas pencarian | POST /api/accounts/:account_id/tasks/search | Tugas kueri berdasarkan filter jenis/status |
| Dapatkan tugas | GET /api/tasks/:task_id | Ambil satu tugas |
| Perbarui tugas | PATCH /api/tasks/:task_id | Ubah bidang tugas yang bisa diubah |
| Hapus tugas | DELETE /api/tasks/:task_id | Hapus tugas |
| Tugas pemicu | POST /api/tasks/:task_id/trigger | Mulai atau mulai ulang eksekusi dari tugas |
Data dan Status Utama
{
id: "tsk_...",
account_id: "acc_...",
task_type: "imap_sync_messages",
target_credential_id: "pc_...",
payload: { folder: "INBOX" },
priority: 0
}Mode dan Kontrol Kegagalan
Muatan tugas atau referensi target yang tidak valid ditolak sebelum eksekusi antrean dimulai. Tindakan pemicu bersifat eksplisit dan mencakup tugas, pemeriksaan akses akun berlaku untuk membuat/membaca/memutasi batasan, dan penghapusan tugas tidak terjadi sebagai efek samping dari pembersihan pekerjaan yang tidak terkait.