Tareas y activación manual

Tareas y activación manual

Propósito: crear registros de tareas explícitos y activar el trabajo en cola asociado.

Flujo de interfaz de usuario

1. El usuario define una carga útil y una prioridad de la tarea.
2. La interfaz de usuario llama a POST /api/accounts/:account_id/tasks.
3. La interfaz de usuario muestra el cronograma de tareas desde /api/accounts/:account_id/tasks.
4. El usuario puede activar la tarea con POST /api/tasks/:task_id/trigger.
5. La interfaz de usuario vincula la tarea a la lista de trabajos filtrada por task_id.

Flujo de la biblioteca del cliente

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);

Flujo 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}"

Notas

• Las rutas de acción del proveedor siguen siendo la ruta principal del cliente para las operaciones IMAP/SMTP.
• Las tareas genéricas son útiles para flujos de trabajo de colas explícitos y herramientas de operaciones.