タスクと手動トリガー

タスクと手動トリガー

目的: 明示的なタスク レコードを作成し、関連するキュー作業をトリガーします。

UI フロー

1. ユーザーはタスクのペイロードと優先度を定義します。
2. UI は POST /api/accounts/:account_id/tasks を呼び出します。
3. UI には /api/accounts/:account_id/tasks からのタスク タイムラインが表示されます。
4. ユーザーは POST /api/tasks/:task_id/trigger を使用してタスクをトリガーできます。
5. UI はタスクを task_id でフィルタリングされたジョブ リストにリンクします。

クライアント ライブラリ フロー

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

HTTP/カールフロー

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

注意事項

• プロバイダー アクション ルートは、依然として IMAP/SMTP 操作のプライマリ クライアント パスです。
• 汎用タスクは、明示的なキュー ワークフローと運用ツールに役立ちます。