查詢智慧字幕連結

更新時間：2024-04-22 19:18:32

介面描述

1、查询视频字幕的链接（需先创建智能字幕任务）
2、接口支持https协议

介面URL

https://api.polyv.net/vod/v4/smart-subtitle/subtitle-link/get

請求方式

GET

介面限制

1、介面同時支援HTTP、HTTPS，建議使用HTTPS以確保介面安全，介面呼叫有頻率限制，詳細請查看

請求參數描述

URL參數

參數名	必選	類型	說明
appId	true	String	直播appId。可在「雲點播」->「設定」->「API介面」中查看您的直播appId和appSecret
timestamp	true	Long	目前時間的毫秒級時間戳記，30分鐘內有效
vid	true	String	影片vid
sign	true	String	簽名，32位元大寫MD5值【詳見MD5簽名產生規則】

回應參數描述

參數名	類型	說明
code	Integer	回應狀態碼，200為成功返回，非200為失敗【詳見全域錯誤說明】
status	String	回應狀態文字資訊
requestId	String	請求唯一識別碼，如遇介面呼叫失敗情況，可發此id給客服輔助排查問題
success	boolean	true代表介面呼叫成功，false代表介面呼叫失敗
data	List	成功時返回字幕資料【詳見data欄位說明】
error	Object	介面呼叫失敗時的描述資訊，【詳見error欄位說明】

data欄位說明

參數名	類型	說明
taskId	Long	字幕任務id
link	String	字幕連結
vid	String	影片vid

error欄位說明

參數名	類型	說明
code	Integer	錯誤碼【詳見返回錯誤代碼列表】
desc	String	錯誤描述【詳見返回錯誤代碼列表】

返回錯誤代碼列表

code	desc	說明
10002	簽名錯誤	簽名錯誤，請檢查介面sign參數是否已正常產生
10003	時間戳記過期	時間戳記過期
20003	application not found.	appId不存在，請檢查appId是否正確傳值

回應範例

成功範例

{
  "code": 200,
  "status": "success",
  "requestId": "f813d5d2359743028b6648e54ade1bf1.60.16801640807450383",
  "data": [
    {
      "taskId": 1120,
      "link": "https://img.videocc.net/usrt/xxxxxxxxx.srt",
      "vid": "c560fac50feda7d3128030f0e71e8c7a_c"
    },
    {
      "taskId": 1271,
      "link": "https://img.videocc.net/usrt/xxxxxxxxx.srt",
      "vid": "c560fac50fa69535f18f0347140cbf75_c"
    }
  ],
  "success": true
}

異常範例

時間戳記過期

{
    "code": 400,
    "status": "error",
    "error": {
        "code": 10003,
        "desc": "时间戳过期"
    },
    "success": false
}

簽名錯誤

{
    "code": 403,
    "status": "error",
    "error": {
        "code": 10002,
        "desc": "签名错误"
    },
    "success": false
}