Pekerjaan

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.