Tâches
La fonctionnalité de tâches définit les demandes de travail du fournisseur au niveau de l’intention avant que l’exécution n’entre dans la file d’attente. Il vous offre un contrôle explicite de l’orchestration afin que les opérations de la boîte de réception puissent être créées, inspectées et déclenchées de manière déterministe.
Pourquoi c’est important
Cette fonctionnalité sépare l’intention commerciale des détails d’exécution de la file d’attente en faisant de l’enregistrement de la tâche la source de vérité pour le travail demandé. Il prend en charge le déclenchement explicite et l’auditabilité avant la distribution des tâches, ce qui permet à l’opérateur de conserver un contrôle clair lorsque l’automatisation nécessite une intervention.
Flux de base
Un client crée une tâche avec un type, une cible et une charge utile, puis utilise cet enregistrement comme intention canonique d’exécution. Lorsqu’elles sont déclenchées, les tâches en file d’attente sont créées à partir de la tâche et les lectures ultérieures reflètent l’état de la tâche et les résultats des tâches liées.
Opérations
| Opération | Point de terminaison | Objectif |
|---|---|---|
| Créer une tâche | POST /api/accounts/:account_id/tasks | Enregistrer une nouvelle intention de tâche limitée au compte |
| Liste des tâches | GET /api/accounts/:account_id/tasks | Récupérer la chronologie des tâches pour le compte |
| Rechercher des tâches | POST /api/accounts/:account_id/tasks/search | Tâches de requête par filtres de type/état |
| Obtenir la tâche | GET /api/tasks/:task_id | Récupérer une tâche |
| Tâche de mise à jour | PATCH /api/tasks/:task_id | Modifier les champs de tâches mutables |
| Supprimer la tâche | DELETE /api/tasks/:task_id | Supprimer la tâche |
| Tâche de déclenchement | POST /api/tasks/:task_id/trigger | Démarrer ou redémarrer l’exécution à partir de la tâche |
Données clés et état
{
id: "tsk_...",
account_id: "acc_...",
task_type: "imap_sync_messages",
target_credential_id: "pc_...",
payload: { folder: "INBOX" },
priority: 0
}Modes de défaillance et contrôles
Les charges utiles de tâches ou les références cibles non valides sont rejetées avant le début de l’exécution de la file d’attente. Les actions de déclenchement sont explicites et limitées aux tâches, les contrôles d’accès aux comptes s’appliquent aux limites de création/lecture/mutation, et la suppression des tâches ne se produit pas comme un effet secondaire d’un nettoyage de tâches sans rapport.
Connexes
[Tâche] (/fr/types/task), [Tâche] (/fr/types/job), [08-tâches-et-déclenchement-manuel] (/fr/guides/08-tasks-and-manual-triggering).