优酷开放云

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

无

帮助文档

获取视频基本信息

1. 接口描述

2. 系统参数

3. 业务参数

4. 返回参数

5. 调用示例

6. 响应示例

7. 异常示例

8. 注意事项