查詢 AI 任務

接口概述

按任務 ID 查詢進度。完成時回傳摘要；失敗時回傳任務錯誤。

接口資訊

AI 任務 · 查詢 AI 任務

GET /v1/ai/tasks/{task_id}

認證方式：請求需在 Header 中攜帶 Authorization: Bearer <API_KEY>。資源 ID 透過 URL 路徑參數傳遞。

下表列出此接口支援的所有輸入參數及約束條件：

參數名稱	類型	約束	說明
task_id	path string	必填	建立任務後取得的 ID。

狀態碼：200 OK

參數名稱	類型	約束	說明
id	string	必填	任務 ID。
status	string	必填	queued、running、succeeded 或 failed。
output.summary	string	可選	僅在 succeeded 時提供。
error.code	string	可選	僅在 failed 時提供的任務錯誤碼。
error.message	string	可選	僅在 failed 時提供的任務錯誤說明。
request_id	string	必填	本次查詢的追蹤 ID。

回應正文範例 · application/json

{
  "id": "task_01JEXAMPLE",
  "status": "succeeded",
  "output": {
    "summary": "會議確認了跨地域系統連接的需求及下一步工作。"
  },
  "request_id": "req_02JEXAMPLE"
}

將 <API_BASE_URL> 替換為 WiseLink 分配的端點地址，將 <API_KEY> 替換為您的訪問金鑰：

請求示例 · cURL

curl -X GET "<API_BASE_URL>/v1/ai/tasks/{task_id}" \
  -H "Authorization: Bearer <API_KEY>" \

錯誤響應說明

參數無效時返回 400 VALIDATION_ERROR；憑證缺失或失效返回 401 UNAUTHORIZED；無權訪問返回 403 FORBIDDEN；指定資源不存在返回 404 NOT_FOUND。完整錯誤碼與指數退避策略請參閱錯誤與重試指南。