Tareas
La función de tareas define las solicitudes de trabajo del proveedor a nivel de intención antes de que la ejecución ingrese a la cola. Le brinda control de orquestación explícito para que las operaciones de la bandeja de entrada se puedan crear, inspeccionar y activar de manera determinista.
Por qué esto importa
Esta característica separa la intención comercial de los detalles de ejecución de la cola al hacer que la tarea registre la fuente de verdad del trabajo solicitado. Admite activación explícita y auditabilidad antes de la distribución del trabajo, lo que mantiene claro el control del operador cuando la automatización necesita intervención.
Flujo central
Un cliente crea una tarea con tipo, destino y carga útil, luego usa ese registro como intención canónica para la ejecución. Cuando se activa, los trabajos en cola se crean a partir de la tarea y las lecturas posteriores reflejan el estado de la tarea y los resultados de los trabajos vinculados.
Operaciones
| Operación | Punto final | Objetivo |
|---|---|---|
| Crear tarea | POST /api/accounts/:account_id/tasks | Registrar una nueva intención de tarea con alcance de cuenta |
| Listar tareas | GET /api/accounts/:account_id/tasks | Obtener cronograma de tareas para la cuenta |
| Tareas de búsqueda | POST /api/accounts/:account_id/tasks/search | Tareas de consulta por filtros de tipo/estado |
| obtener tarea | GET /api/tasks/:task_id | Recuperar una tarea |
| Tarea de actualización | PATCH /api/tasks/:task_id | Modificar campos de tareas mutables |
| Eliminar tarea | DELETE /api/tasks/:task_id | Quitar tarea |
| Tarea desencadenante | POST /api/tasks/:task_id/trigger | Iniciar o reiniciar la ejecución desde la tarea |
Datos clave y estado
{
id: "tsk_...",
account_id: "acc_...",
task_type: "imap_sync_messages",
target_credential_id: "pc_...",
payload: { folder: "INBOX" },
priority: 0
}Modos de falla y controles
Las cargas útiles de tareas o las referencias de destino no válidas se rechazan antes de que comience la ejecución de la cola. Las acciones desencadenantes son explícitas y tienen un alcance de tarea, se aplican verificaciones de acceso a la cuenta para crear/leer/mutar límites, y la eliminación de tareas no ocurre como un efecto secundario de la limpieza de trabajos no relacionados.