Pekerjaan
Fitur pekerjaan mendefinisikan unit antrean yang dapat dieksekusi yang berasal dari tugas dan peristiwa penyedia. Ini memberi Anda kontrol operasional langsung atas percobaan ulang, pemicuan manual, dan resolusi ketika pekerjaan asinkron gagal.
Mengapa Ini Penting
Fitur ini membuat eksekusi antrean dapat diamati pada perincian per tugas, sehingga kegagalan dapat didiagnosis dan dipulihkan tanpa perlu menebak-nebak. Hal ini mendukung pemulihan operator deterministik melalui tindakan percobaan ulang, pemicuan, dan penyelesaian secara eksplisit sambil menjaga operasi pembersihan dilakukan secara disengaja dan tercakup.
Aliran Inti
Tugas atau peristiwa penyedia menghasilkan pekerjaan yang dijalankan pekerja dan dianotasi dengan status, upaya, dan detail kegagalan. Operator meninjau pekerjaan yang gagal atau terhenti dalam tampilan antrean akun, menjalankan tindakan coba ulang/penyelesaian/pemicu yang eksplisit, dan menggunakan status pekerjaan yang dihasilkan untuk melacak siklus hidup tugas dan jejak audit.
Operasi
| Operasi | Endpoint | Tujuan |
|---|---|---|
| Daftar pekerjaan | GET /api/accounts/:account_id/jobs |
Ambil antrian pekerjaan akun |
| Cari pekerjaan | POST /api/accounts/:account_id/jobs/search |
Kueri pekerjaan berdasarkan filter |
| Hapus pekerjaan berdasarkan pencarian | POST /api/accounts/:account_id/jobs/search-delete |
Hapus secara massal pekerjaan yang cocok |
| Dapatkan pekerjaan | GET /api/jobs/:job_id |
Ambil satu pekerjaan |
| Perbarui pekerjaan | PATCH /api/jobs/:job_id |
Ubah bidang pekerjaan yang bisa berubah |
| Hapus pekerjaan | DELETE /api/jobs/:job_id |
Hapus satu pekerjaan |
| Coba lagi pekerjaan | POST /api/jobs/:job_id/retry |
Permintaan pekerjaan yang gagal |
| Selesaikan pekerjaan | POST /api/jobs/:job_id/resolve |
Tandai status penanganan terminal |
| Pekerjaan pemicu | POST /api/jobs/:job_id/trigger |
Pemicu eksekusi paksa |
Data dan Status Utama
{
id: "job_...",
account_id: "acc_...",
task_id: "tsk_...",
action: "imap_sync_messages",
attempt_count: 2,
last_error_code: "provider_timeout",
last_error_detail: "IMAP connection timed out"
}Mode dan Kontrol Kegagalan
Eksekusi yang gagal mempertahankan detail kesalahan eksplisit untuk penanganan deterministik. Coba lagi, picu, dan selesaikan adalah operasi bergaya perintah, bukan efek samping baca implisit, dan batas daftar/pencarian cakupan akun mencegah visibilitas antrean lintas akun.
Terkait
Pekerjaan, Tugas, 07-pekerjaan-percobaan ulang-dan-penyelesaian.