任務狀態

任務詳細狀態 API

查看特定任務的詳細資訊和進度。

端點資訊

  • URL: /api/queue/job/:jobId/status
  • 方法: GET

請求範例

curl http://18.141.225.228:3000/api/queue/job/job_1759060760034_abc123/status

響應格式

{
  "jobId": "job_1759060760034_abc123",
  "status": "processing",
  "progress": 65,
  "videoId": "peUO_55ck4o",
  "createdAt": "2025-01-15T10:30:00Z",
  "startedAt": "2025-01-15T10:31:00Z",
  "estimatedCompletion": "2025-01-15T10:35:00Z"
}

狀態值說明

狀態說明
pending等待處理
queued已加入佇列
processing處理中
completed已完成
failed失敗
cancelled已取消

輪詢建議

建議每 2-5 秒輪詢一次,避免過度請求。

// 輪詢範例
async function pollJobStatus(jobId) {
  const interval = setInterval(async () => {
    const response = await fetch(
      \`http://18.141.225.228:3000/api/queue/job/${jobId}/status\`
    );
    const data = await response.json();
    
    if (data.status === "completed") {
      clearInterval(interval);
      console.log("翻譯完成!");
    } else if (data.status === "failed") {
      clearInterval(interval);
      console.error("翻譯失敗");
    } else {
      console.log(\`進度: ${data.progress}%\`);
    }
  }, 3000);
}