获取用户视频列表

1. 接口描述

URL https://openapi.youku.com/router/rest.json
功能描述 获取用户视频列表信息
返回格式 json,UTF8
HTTP请求方式 GET
是否需要登录
当前接口版本 V3

2. 系统参数

参数名 参数全称 必选 参数类型 参数描述
action action true String youku.api.vod.getbcid.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. 业务参数

参数名 参数全称 必选 参数类型 参数描述
status status false int 视频状态
categoryid categoryid false String 分类_id
page_length page_length false int 页码大小默认为30,最大为50
page page false int 页码默认1

4. 返回参数

参数名 参数全称 必选 参数类型 参数描述
error error true object 错误码
cost cost true float 接口执行时间
_id _id true string 视频ID
customer_id customer_id true string 客户id
sid sid true long 视频自增ID
title title true string 视频时间
tags tags true string 视频标签
desc desc true string 视频描述
ip ip true string 视频上传IP
ct ct true long 记录创建时间
attr_values attr_values true jsonarray 视频属性
category_id category_id true int 视频分类
fid fid true long 文件ID
status status true int 文件状态
poster_url poster_url true string 截图地址

5. 调用示例

https://openapi.youku.com/router/rest.json?page_length=5&opensysparams=
{"client_id": "163d4fd10c7f9a28", "action": "youku.api.vod.getbcid.videoinfo",
 "sign": "ddf43d96b0c8368e6f6b62f22917f2b2", "format": "json", "version": 
"3.0", "timestamp": 1466999847}&customer_id=55b1e538e4b075d6cceec82c&page=1
  			

6. 响应示例

{
    "total": 206,
    "e": {
        "desc": "",
        "provider": "cloudvideo",
        "code": 0
    },
    "page": 1,
    "data": [
        {
            "fid": 177,
            "thumbs": [
                {
                    "fid": 177,
                    "sid": 95,
                    "time": 10,
                    "_id": "569c9e890cf2a4d6a9470741",
                    "file_size": 174221,
                    "seq_no": "1",
                    "thumb_url": "http://kvod.open.youku.com/cloudvideo/kservice-route/get.json?fid=05A000009569C9E89000000000EB3C659.png&ns=uvod-thumb.cloud.youku.com&customer_id=55b1e538e4b075d6cceec82c",
                    "file_name": "05A000009569C9E89000000000EB3C659.png",
                    "type_id": 1
                },
                {
                    "fid": 177,
                    "sid": 2504300,
                    "time": 10,
                    "_id": "55d6c675e4b0203b47f3ca11",
                    "file_size": 95784,
                    "seq_no": "0",
                    "thumb_url": "http://kvod.open.youku.com/cloudvideo/kservice-route/get.json?fid=05A00000D55D6C675000000006E4A221B.png&ns=uvod-thumb.cloud.youku.com&customer_id=55b1e538e4b075d6cceec82c",
                    "file_name": "05A00000D55D6C675000000006E4A221B.png",
                    "type_id": 1
                }
            ],
            "desc": "dscp2",
            "post_url": "http://101.201.172.30/cloudvideo/kservice-route/get.json?fid=05A000009569C9E89000000000EB3C659.png&ns=uvod-thumb.cloud.youku.com&customer_id=55b1e538e4b075d6cceec82c",
            "sync_status": 0,
            "title": "lx3m.avi",
            "checkStatus": 1,
            "_id": "569c9e7f0cf2ebcd9893f552",
            "file_id": "569c9e7f0cf2ebcd9893f551",
            "lut": 1469004657,
            "tags": "tab2",
            "sid": 288,
            "lock_time": 1466130241,
            "file_size": 1120142,
            "status": 1,
            "recycled": 0,
            "category_id": 0,
            "property": 1,
            "check_time": 1466130328,
            "operator": "57550f710cf26b7b2c6733bd",
            "ct": 1453104767,
            "duration": 36,
            "categoryid": "",
            "subcate_id": 0,
            "source": 1,
            "player_id": 9,
            "channel": 0,
            "customer_id": "55b1e538e4b075d6cceec82c"
        },
        {
            "fid": 0,
            "thumbs": "",
            "desc": "kkdjx",
            "post_url": "http://r1.ykimg.com/0541040850D31C7C6A0A4471CC126751",
            "sync_status": 0,
            "source_account": "754157",
            "title": "最终版",
            "checkStatus": 1,
            "_id": "57876f370cf23582dfcf095a",
            "file_id": "",
            "lut": 1468493623,
            "tags": "惊喜",
            "sid": 5504360,
            "file_size": 0,
            "status": 1,
            "recycled": 0,
            "source_id": "XNDkxMDA0NjQ4",
            "category_id": 0,
            "property": 1,
            "check_time": 1468493623,
            "operator": "5750e5060cf26b7b2c6733ae",
            "ct": 1356011093,
            "duration": 247,
            "categoryid": "",
            "subcate_id": 0,
            "source": 2,
            "player_id": 0,
            "customer_id": "55b1e538e4b075d6cceec82c"
        },
        {
            "fid": 0,
            "thumbs": "",
            "desc": "linda",
            "post_url": "http://r4.ykimg.com/05410408519D64E36A0A4A045E139FBD",
            "sync_status": 0,
            "source_account": "754157",
            "title": "只如初见的人生",
            "checkStatus": 1,
            "_id": "57876f170cf20c4981a057b1",
            "file_id": "",
            "lut": 1468493591,
            "tags": "marry",
            "sid": 5504358,
            "file_size": 0,
            "status": 7,
            "recycled": 0,
            "source_id": "XNTYyODk1NjIw",
            "category_id": 0,
            "property": 1,
            "check_time": 1468493591,
            "operator": "5750e5060cf26b7b2c6733ae",
            "ct": 1369702156,
            "duration": 357,
            "categoryid": "",
            "subcate_id": 0,
            "source": 2,
            "player_id": 0,
            "customer_id": "55b1e538e4b075d6cceec82c"
        },
        {
            "thumbs": [
                {
                    "fid": 5007890,
                    "sid": 5004936,
                    "time": 10,
                    "_id": "578768fe0cf29a89f0eeaaa5",
                    "file_size": 77710,
                    "seq_no": "1",
                    "thumb_url": "http://kvod.open.youku.com/cloudvideo/kservice-route/get.json?fid=05A00000A578768FE00000000976C23C2.png&ns=uvod-thumb.cloud.youku.com&customer_id=55b1e538e4b075d6cceec82c",
                    "file_name": "05A00000A578768FE00000000976C23C2.png",
                    "type_id": 1
                }
            ],
            "fid": 5007890,
            "sid": 5504309,
            "lock_time": 1468548853,
            "file_size": 2816688530,
            "status": 1,
            "recycled": 0,
            "post_url": "http://kvod.open.youku.com/cloudvideo/kservice-route/get.json?fid=05A00000A578768FE00000000976C23C2.png&ns=uvod-thumb.cloud.youku.com&customer_id=55b1e538e4b075d6cceec82c",
            "category_id": 0,
            "property": 1,
            "sync_status": 0,
            "resolution": "1920x800",
            "check_time": 1468549091,
            "ct": 1468491491,
            "operator": "575632440cf26b7b2c6733c0",
            "categoryid": "",
            "duration": 6609,
            "title": "遇见你之前.Me.Before.You.2016.HD1080P",
            "checkStatus": 1,
            "subcate_id": 0,
            "source": 1,
            "_id": "578766e30cf20c4981a05783",
            "ratio": "12:5",
            "file_id": "578766e30cf20c4981a05782",
            "lut": 1468491491,
            "player_id": 0,
            "channel": 0,
            "customer_id": "55b1e538e4b075d6cceec82c"
        },
        {
            "thumbs": [
                {
                    "fid": 5007889,
                    "sid": 5004930,
                    "time": 10,
                    "_id": "578767660cf2a8d13250aa49",
                    "file_size": 128286,
                    "seq_no": "1",
                    "thumb_url": "http://kvod.open.youku.com/cloudvideo/kservice-route/get.json?fid=05A0000025787676600000000E020D96D.png&ns=uvod-thumb.cloud.youku.com&customer_id=55b1e538e4b075d6cceec82c",
                    "file_name": "05A0000025787676600000000E020D96D.png",
                    "type_id": 1
                }
            ],
            "fid": 5007889,
            "sid": 5504308,
            "lock_time": 1468548853,
            "file_size": 146113687,
            "status": 1,
            "recycled": 0,
            "post_url": "http://kvod.open.youku.com/cloudvideo/kservice-route/get.json?fid=05A0000025787676600000000E020D96D.png&ns=uvod-thumb.cloud.youku.com&customer_id=55b1e538e4b075d6cceec82c",
            "category_id": 0,
            "property": 1,
            "sync_status": 0,
            "resolution": "512x288",
            "check_time": 1468549091,
            "ct": 1468491488,
            "operator": "575632440cf26b7b2c6733c0",
            "categoryid": "",
            "duration": 2788,
            "title": "女医明妃传 47_标清.flv",
            "checkStatus": 1,
            "subcate_id": 0,
            "source": 1,
            "_id": "578766e00cf2a8d13250aa45",
            "ratio": "16:9",
            "file_id": "578766e00cf2a8d13250aa44",
            "lut": 1468491488,
            "player_id": 0,
            "channel": 0,
            "customer_id": "55b1e538e4b075d6cceec82c"
        }
    ],
    "cost": 0.023000001907348633,
    "pageLength": 5
}

7. 异常示例

8. 注意事项