文档中心 > API类目 > 虚拟院线API

youku.tv.desktop.toyou.recommend (TV桌面为你推荐接口)

提供为你推荐数据

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
token String 可选 abc 用户登陆token
bcp String 必须 1 播控方,1:华数 7:CIBN
device_model String 可选 magic_box 终端设备型号
version_code Number 可选 201240012
  • 默认值:0
  • 桌面版本号
    mac String 可选 abc 终端设备mac
    uuid String 必须 B23C981D6F7BB4C1A7A693AAD18AC931 终端设备uuid
    from String 可选 0,7,9 影视来源,0-淘tv 7-优酷免费 9-优酷付费 多项用“,”隔开
    charge_type String 可选 2,3,5 支持收费方式,0-免费 1-限免 2-单点 3-包月 4-红包 5-单包,多项用“,”隔开
    max_size Number 必须 12 获取的最大节目数
    sw String 可选 sw720 分辨率,sw720 sw1080
    device_media String 可选 h265_4k2k 支持媒体类型,dts,drm,dolby,h265
    ip String 可选 127.0.0.1 请求IP

    响应参数

    名称 类型 示例值 描述
    results V5BaseItemRbo [] [] 响应的结果列表
    • └ id
    • Number
    • 1
    • 坑位ID
    • └ title
    • String
    • 长城
    • 坑位标题
    • └ subtitle
    • String
    • 长城续集
    • 坑位子标题
    • └ center_pic
    • String
    • http://image.png
    • 中间图片
    • └ bg_pic
    • String
    • http://image.png
    • 背景图片
    • └ bg_pic_gif
    • String
    • http://image.gif
    • 背景动图(高配)
    • └ biz_type
    • String
    • PROGRAM
    • 跳转行为
    • └ extra
    • String
    • {}
    • 扩展字段
    • └ extra_str
    • String
    • id:12121
    • 未解析的扩展字段
    • └ item_type
    • String
    • 7
    • 坑位类型
    • └ score
    • String
    • 1
    • 评分
    • └ recommend_rule_id
    • Number
    • 1
    • 推荐主题ID
    • └ recommend_reason
    • String
    • 大家都在看
    • 推荐理由

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    YoukuTvDesktopToyouRecommendRequest req = new YoukuTvDesktopToyouRecommendRequest();
    req.setToken("abc");
    req.setBcp("1");
    req.setDeviceModel("magic_box");
    req.setVersionCode(201240012L);
    req.setMac("abc");
    req.setUuid("B23C981D6F7BB4C1A7A693AAD18AC931");
    req.setFrom("0,7,9");
    req.setChargeType("2,3,5");
    req.setMaxSize(12L);
    req.setSw("sw720");
    req.setDeviceMedia("h265_4k2k");
    req.setIp("127.0.0.1");
    YoukuTvDesktopToyouRecommendResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <youku_tv_desktop_toyou_recommend_response>
        <results>
            <v5_base_item_rbo>
                <id>1</id>
                <title>长城</title>
                <subtitle>长城续集</subtitle>
                <center_pic>http://image.png</center_pic>
                <bg_pic>http://image.png</bg_pic>
                <bg_pic_gif>http://image.gif</bg_pic_gif>
                <biz_type>PROGRAM</biz_type>
                <extra>{}</extra>
                <extra_str>id:12121</extra_str>
                <item_type>7</item_type>
                <score>1</score>
                <recommend_rule_id>1</recommend_rule_id>
                <recommend_reason>大家都在看</recommend_reason>
            </v5_base_item_rbo>
        </results>
    </youku_tv_desktop_toyou_recommend_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部