YouTube 單個下載任務資訊 API

/download/info/job API endpoint allows you to query the status and details of a single download job.

API 詳情

請求端點 GET https://dlapi.abcproxy.com/download/info/job

說明： 查詢單一 YouTube 影片下載任務的狀態與詳細資訊，包含下載進度及下載完成後的影片中繼資料。

---

請求範例

HTTP 請求方式

---

cURL

curl -X GET "https://dlapi.abcproxy.com/download/info/job?job_id=411e81d8-237c-4c96-b946-990ade660c1d"

Python

import requests

params = {
    "job_id": "411e81d8-237c-4c96-b946-990ade660c1d"
}
response = requests.get("https://dlapi.abcproxy.com/download/info/job", params=params)
print(response.json())

Node.js

const axios = require('axios');

const params = {
  job_id: "411e81d8-237c-4c96-b946-990ade660c1d"
};

axios.get("https://dlapi.abcproxy.com/download/info/job", { params })
  .then(response => console.log(response.data));

HTTP

GET /download/info/job?job_id=411e81d8-237c-4c96-b946-990ade660c1d HTTP/1.1
Host: dlapi.abcproxy.com

API 參數說明

搜尋參數

參數名稱	類型	必填項	說明	範例
job_id	字符串	是	要查詢的任務 ID	"411e81d8-237c-4c96-b946-990ade660c1d"

---

響應

成功回應（HTTP 200）

完成範例

{
  "code": 200,
  "msg": "Success",
  "data": {
    "job_id": "a082eec0-8902-4016-b38a-0dce65d309f9",
    "video_id": "ONZZvc_IqQg",
    "status": "completed",
    "error": "",
    "video_info": {
      "url": "https://www.youtube.com/watch?v=ONZZvc_IqQg",
      "video_id": "ONZZvc_IqQg",
      "download_url": "https://s3-service.exampleapi.net/files/youtube/videos/ONZZvc_IqQg_5992d185990a55f38ca4cadb79cd9188.mp4",
      "title": "Rust and Linux",
      "duration": 729,
      "resolution": "640x360"
    }
  }
}

失敗範例

{
  "code": 200,
  "msg": "Success",
  "data": {
    "job_id": "a082eec0-8902-4016-b38a-0dce65d309f9",
    "video_id": "ONZZvc_IqQg",
    "status": "failed",
    "error": "Download failed",
    "video_info": {}
  }
}

待處理範例

{
  "code": 200,
  "msg": "Success",
  "data": {
    "job_id": "a082eec0-8902-4016-b38a-0dce65d309f9",
    "video_id": "ONZZvc_IqQg",
    "status": "pending",
    "error": "",
    "video_info": {}
  }
}

回應欄位說明

欄位名稱	類型	說明
code	整數型	回應代碼（200 代表成功）
msg	字符串	回應訊息
data.job_id	字符串	任務 ID
data.video_id	字符串	YouTube 影片 ID
data.status	字符串	任務狀態（pending：處理中、completed：已完成、failed：失敗）
data.error	字符串	若任務失敗，會返回錯誤訊息
data.video_info	對象	影片中繼資料（僅完成任務時提供）
video_info.url	字符串	原始 YouTube 網址
video_info.video_id	字符串	YouTube 影片 ID
video_info.download_url	字符串	可下載影片的公開連結
video_info.title	字符串	影片標題
video_info.duration	整數型	影片長度（單位為秒）
video_info.resolution	字符串	影片解析度（格式為 寬x高，例如：640x360）

---

錯誤回應

常見錯誤

HTTP 狀態碼	錯誤代碼	說明
400	Invalid job ID	提供的任務 ID 無效或缺失
404	Job not found	找不到對應的任務 ID
500	Internal server error	伺服器內部錯誤

錯誤回應範例

{
  "code": 404,
  "msg": "Job not found",
  "data": null
}

---

備註

1. download_url 為影片下載完成後的公開下載連結

2. 若任務狀態為 pending 或 failed，video_info 對象將為空

3. error 欄位在任務失敗時會提供詳細錯誤原因