Tugas Dan Pemicu Manual
Tujuan: membuat catatan tugas eksplisit dan memicu pekerjaan antrian terkait.
Aliran UI
- Pengguna menentukan muatan dan prioritas tugas.
- UI memanggil
POST /api/accounts/:account_id/tasks. - UI menunjukkan garis waktu tugas dari
/api/accounts/:account_id/tasks. - Pengguna dapat memicu tugas dengan
POST /api/tasks/:task_id/trigger. - UI menghubungkan tugas ke daftar pekerjaan yang difilter berdasarkan
task_id.
Alur Perpustakaan Klien
const task = await api.tasks.create(accountId, {
task_type: "imap_sync_messages",
target_credential_id: imapCredentialId,
payload: { folder: "INBOX" },
priority: 0,
});
await api.tasks.trigger(task.data.id);
const refreshed = await api.tasks.get(task.data.id);
Alur HTTP/curl
API_BASE_URL="https://api.inbox-manager.com"
curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/tasks" \
-H "authorization: Bearer ${BEARER_TOKEN}" \
-H "content-type: application/json" \
--data '{
"task_type":"imap_sync_messages",
"target_credential_id":"'"${IMAP_CREDENTIAL_ID}"'",
"payload":{"folder":"INBOX"},
"priority":0
}'
curl -sS -X POST "${API_BASE_URL}/api/tasks/${TASK_ID}/trigger" \
-H "authorization: Bearer ${BEARER_TOKEN}" \
-H "content-type: application/json" \
--data '{}'
curl -sS "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/tasks?limit=20&offset=0" \
-H "authorization: Bearer ${BEARER_TOKEN}"
Catatan
- Rute tindakan penyedia masih menjadi jalur klien utama untuk operasi IMAP/SMTP.
- Tugas umum berguna untuk alur kerja antrean eksplisit dan perkakas operasi.