帮助文档
获取视频基本信息
1. 接口描述
| URL | https://openapi.youku.com/router/rest.json |
| 功能描述 | 通过视频ID获取视频信息，包括标题、标签、描述等。 |
| 返回格式 | json，UTF8 |
| HTTP请求方式 | GET |
| 是否需要登录 | 是 |
| 当前接口版本 | V3 |
2. 系统参数
| 参数名 | 参数全称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|---|
| action | action | true | String | youku.api.vod.getbyid.videoinfo |
| client_id | client_id | true | String | 应用的client id |
| access_token | access token | false | String | oauth2的token |
| timestamp | timestamp | true | String | 客户端当前时间戳，精确到秒，timestamp与开放平台请求时间误差为6分钟 |
| version | version | true | String | API协议版本，默认值3.0 |
| sign_method | sign_method | false | String | 签名的摘要算法，可选值为：HmacSHA256，md5。默认为md5 |
| sign | sign | true | String | 对API调用参数（除sign外）的md5加密值。详情见签名方法 |
3. 业务参数
| 参数名 | 参数全称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|---|
| _id | _id | true | String | 视频信息_id，注：此处做签名时需要排在最前面 |
4. 返回参数
| 参数名 | 参数全称 | 必选 | 参数类型 | 参数描述 |
|---|---|---|---|---|
| error | error | true | object | 错误码 |
| cost | cost | true | float | 接口执行时间 |
| _id | _id | true | string | 视频ID |
| cost | cost | true | float | 接口执行时间 |
| sid | sid | true | long | 视频自增ID |
| title | title | true | string | 视频标题 |
| ct | ct | true | long | 记录创建时间 |
| category_id | category_id | true | int | 视频分类 |
| fid | fid | true | long | 文件ID |
| status | status | true | int | 文件状态0:上传中,1:正常,2:上传完成,3:转码中,4:转码失败,7:删除 |
| post_url | post_url | true | string | 截图地址 |
5. 调用示例
https://openapi.youku.com/router/rest.json?_id=5763cd700cf228b150b91bc8&opensysparams={"format":"json",
"action":"youku.api.vod.getbyid.videoinfo","client_id":"163d4fd10c7f9a28","sign":
"02f54f9b12460c995b0a9a2de4d4c1dc","version":"3.0","timestamp":1466999847}
6. 响应示例
{
"e": {
"desc": "",
"provider": "cloudvideo",
"code": 0
},
"data": {
"thumbs": [
{
"fid": 5006252,
"sid": 5003725,
"time": 10,
"_id": "5763cda30cf2087280feacd9",
"file_size": 144129,
"seq_no": "1",
"thumb_url": "http://kvod.open.youku.com/cloudvideo/kservice-route/get.json?fid=05A0000095763CDA30000000014DF6F23.png&ns=uvod-thumb.cloud.youku.com&customer_id=575cc6b9e4b03fc0adf9d46b",
"file_name": "05A0000095763CDA30000000014DF6F23.png",
"type_id": 1
}
],
"fid": 5006252,
"sid": 5463529,
"lock_time": 1467968784,
"file_size": 19448241,
"status": 7,
"recycled": 0,
"post_url": "http://kvod.open.youku.com/cloudvideo/kservice-route/get.json?fid=05A0000095763CDA30000000014DF6F23.png&ns=uvod-thumb.cloud.youku.com&customer_id=575cc6b9e4b03fc0adf9d46b",
"category_id": 0,
"property": 2,
"sync_status": 0,
"resolution": "640x264",
"check_time": 1467968838,
"ct": 1466158448,
"operator": "575632440cf26b7b2c6733c0",
"categoryid": "",
"duration": 46,
"title": "movie.mp4",
"checkStatus": 1,
"subcate_id": 0,
"source": 1,
"_id": "5763cd700cf228b150b91bc8",
"ratio": "635:264",
"file_id": "5763cd700cf228b150b91bc7",
"lut": 1466158680,
"player_id": 219,
"channel": 1,
"customer_id": "575cc6b9e4b03fc0adf9d46b"
},
"cost": 0.023000001907348633
}
7. 异常示例
无
8. 注意事项
无
400-810-3568 转 4
303221837