# 查询智能字幕链接

### 接口描述

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

### 接口URL

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

### 请求方式

```
GET
```

### 接口约束

1、接口同时支持HTTP 、HTTPS ，建议使用HTTPS 确保接口安全，接口调用有频率限制，[详细请查看](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/limit/README.md)

### 请求参数描述

* URL参数

| 参数名       | 必选   | 类型     | 说明                                                                                                                          |
| --------- | ---- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| appId     | true | String | 直播appId。可在"云点播" -> "设置" -> "API接口" 中查看您的直播appId和appSecret                                                                   |
| timestamp | true | Long   | 当前时间的毫秒级时间戳，30分钟内有效                                                                                                         |
| vid       | true | String | 视频vid                                                                                                                       |
| sign      | true | String | 签名，32位大写MD5值【详见[MD5签名生成规则](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/buildSignMd5/README.md)】 |

### 响应参数描述

| 参数名       | 类型      | 说明                                                                                                                                                                                                         |
| --------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code      | Integer | 响应状态码，200为成功返回，非200为失败【详见[全局错误说明](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/errorInfo/README.md)】                                                                            |
| status    | String  | 响应状态文本信息                                                                                                                                                                                                   |
| requestId | String  | 请求唯一标识，如遇接口调用失败情况，可发此id给客服辅助排查问题                                                                                                                                                                           |
| success   | boolean | true代表接口调用成功，false代表接口调用失败                                                                                                                                                                                 |
| data      | List    | 成功时返回字幕数据【详见[data字段说明](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/video_management/smart_subtitle/query_smart_subtitle.md?id=data%E5%AD%97%E6%AE%B5%E8%AF%B4%E6%98%8E)】       |
| error     | Object  | 接口调用失败时的描述信息，【详见[error字段说明](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/video_management/smart_subtitle/query_smart_subtitle.md?id=error%E5%AD%97%E6%AE%B5%E8%AF%B4%E6%98%8E)】 |

#### data字段说明

| 参数名    | 类型     | 说明     |
| ------ | ------ | ------ |
| taskId | Long   | 字幕任务id |
| link   | String | 字幕链接   |
| vid    | String | 视频vid  |

#### error字段说明

| 参数名  | 类型      | 说明                                                                                                                                                                                                                               |
| ---- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| code | Integer | 错误码 【详见[返回错误代码列表](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/video_management/smart_subtitle/query_smart_subtitle.md?id=%E8%BF%94%E5%9B%9E%E9%94%99%E8%AF%AF%E4%BB%A3%E7%A0%81%E5%88%97%E8%A1%A8)】  |
| desc | String  | 错误描述 【详见[返回错误代码列表](https://git.polyv.net/help-center/document-center/-/blob/master/vod/api/video_management/smart_subtitle/query_smart_subtitle.md?id=%E8%BF%94%E5%9B%9E%E9%94%99%E8%AF%AF%E4%BB%A3%E7%A0%81%E5%88%97%E8%A1%A8)】 |

### 返回错误代码列表

| code  | desc                   | 说明                       |
| ----- | ---------------------- | ------------------------ |
| 10002 | 签名错误                   | 签名错误，请检查接口sign参数是否已经正常生成 |
| 10003 | 时间戳过期                  | 时间戳过期                    |
| 20003 | application not found. | appId不存在，清检查appId是否正确传值  |

### 响应示例

成功示例

```json
{
  "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
}
```

异常示例

时间戳过期

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

签名错误

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