狀態查詢類

工作流程查詢

提供工作流程執行紀錄、即時狀態、任務列表及執行日誌查詢，協助使用者追蹤工作流程進度與排查執行問題。

API 名稱	方法	API Endpoint	功用說明
查詢執行紀錄	GET	/api/dags	查詢 Portal 已記錄且使用者有權查看的工作流程執行紀錄與基本狀態。
查詢即時狀態	GET	/api/dags/{dag_id}/{run_id}/status	查詢指定工作流程單次執行的即時狀態、是否已結束及開始／結束時間。
查詢任務列表	GET	/api/dags/{dag_id}/{run_id}/tasks	查詢指定工作流程單次執行中的任務、狀態、嘗試次數及執行時間。
查詢任務 Log	GET	/api/dags/{dag_id}/{run_id}/tasks/{task_id}/logs/{try_number}	查詢指定任務及指定嘗試次數的執行日誌。

驗證方式

所有 API 均使用 Bearer Token 驗證：

Authorization: Bearer <使用者金鑰>

路徑參數來源

參數	取得方式
dag_id	觸發工作流程後取得，或由查詢執行紀錄 API 回傳。
run_id	觸發工作流程後取得，或由查詢執行紀錄 API 的 dag_run_id 欄位取得。
task_id	由查詢任務列表 API 回傳。
try_number	由查詢任務列表 API 回傳。

📄️ 查詢執行紀錄

查詢 Portal 已記錄且目前使用者有權查看的工作流程執行紀錄與基本狀態。

📄️ 查詢即時狀態

查詢指定工作流程單次執行的即時狀態，包括是否已結束及開始／結束時間。

📄️ 查詢任務列表

查詢指定工作流程單次執行中的任務，包含任務識別碼、狀態、嘗試次數及執行時間。

📄️ 查詢任務 Log

查詢指定任務及指定嘗試次數的執行日誌。預設回傳 JSON；指定 `format=text` 時回傳純文字內容。