获取视频基本信息

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. 注意事项