淘宝开放平台

登录
文档中心 > API类目 > 淘票票数据平台

taobao.film.open.show.nowandsoon.get (淘票票影片-正在热映与即将上映影片列表)

淘票票影片-正在热映与即将上映影片列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
platform Number 可选 1 淘宝渠道号
page_index Number 可选 1
  • 默认值：1
    		•  页码
    page_size Number 可选 10
  • 默认值：10
    		•  页大小

    响应参数

    名称 类型 示例值 描述
    return_value Show [] 包装类型
    • └ background
    • String
    • http://xxx/i1/O1CN01Z8X9vL1VWKHSFmVkb_!!6000000002660-0-alipicbeacon.jpg
    • 背景图片
    • └ company
    • String
    • ""
    • 厂商
    • └ country
    • String
    • 中国大陆,中国香港
    • 国家
    • └ description
    • String
    • ""
    • 详情
    • └ director
    • String
    • 庄文强
    • 出品
    • └ duration
    • Number
    • 125
    • 影片时长
    • └ highlight
    • String
    • ""
    • 重点信息
    • └ language
    • String
    • 粤语
    • 语言
    • └ leader
    • String
    • 张艺谋
    • 导演
    • └ name
    • String
    • 大脑天宫
    • 影片
    • └ name_en
    • String
    • danao
    • 影片
    • └ open_day
    • String
    • 2023-12-20 17:30:00
    • 上映时间
    • └ poster
    • String
    • xxx.jpg
    • 海报
    • └ remark
    • String
    • 9.6
    • 评分
    • └ show_code
    • String
    • bc123214
    • 影片CODE
    • └ show_id
    • String
    • 123
    • 影片ID
    • └ show_mark
    • String
    • 3D
    • 影片标签
    • └ type
    • String
    • 惊悚|搞笑
    • 影片类型
    • └ show_versions
    • String []
    • 影片版本，例如：["IMAX", "3D"]
    • └ trailer_list
    • String []
    • 海报，例如：["https://xx/xxx.jpg"]
    • └ status
    • String
    • 1
    • 状态， 1为正常
    count Number 1 接口数据量
    return_message Number 空 接口错误信息
    return_code String 0 接口通信Code（非0代表异常）

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    1
    2
    3
    4
    5
    6
    7
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    FilmOpenShowNowandsoonGetRequest req = new FilmOpenShowNowandsoonGetRequest();
    req.setPlatform(1L);
    req.setPageIndex(1L);
    req.setPageSize(10L);
    FilmOpenShowNowandsoonGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    <film_open_show_nowandsoon_get_response>
        <return_value>
            <show>
                <background>http://xxx/i1/O1CN01Z8X9vL1VWKHSFmVkb_!!6000000002660-0-alipicbeacon.jpg</background>
                <company>&quot;&quot;</company>
                <country>中国大陆,中国香港</country>
                <description>&quot;&quot;</description>
                <director>庄文强</director>
                <duration>125</duration>
                <highlight>&quot;&quot;</highlight>
                <language>粤语</language>
                <leader>张艺谋</leader>
                <name>大脑天宫</name>
                <name_en>danao</name_en>
                <open_day>2023-12-20 17:30:00</open_day>
                <poster>xxx.jpg</poster>
                <remark>9.6</remark>
                <show_code>bc123214</show_code>
                <show_id>123</show_id>
                <show_mark>3D</show_mark>
                <type>惊悚|搞笑</type>
                <status>1</status>
            </show>
        </return_value>
        <count>1</count>
        <return_message>空</return_message>
        <return_code>0</return_code>
    </film_open_show_nowandsoon_get_response>

    异常示例

    • XML示例
    • JSON示例
    1
    2
    3
    4
    5
    6
    <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测试工具 错误码查询工具 SDK下载

    如何获得此API

    FAQ

    我要提问
    返回
    顶部