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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
platform Number 可选 0
  • 默认值:0
  • 渠道号(城市号,默认传0)
    page_index Number 可选 0
  • 默认值:0
  • 页码下标(从0开始)
    page_size Number 可选 10
  • 默认值:10
  • 页大小

    响应参数

    名称 类型 示例值 描述
    return_value Show [] 包装类型
    • └ show_id
    • Number
    • 123
    • 影片id
    • └ show_name
    • String
    • 大闹天宫
    • 影片名称
    • └ poster
    • String
    • http://xxx/i1/O1CN01Z8X9vL1VWKHSFmVkb_!!6000000002660-0-alipicbeacon.jpg
    • 海报
    • └ score
    • String
    • 9.1
    • 评分
    • └ score_count
    • Number
    • 9999
    • 评分人数
    • └ want_count
    • Number
    • 1000
    • 想看人数
    • └ director
    • String
    • 张艺谋
    • 导演
    • └ leading_role
    • String
    • 刘德华
    • 主演
    • └ type
    • String
    • 惊悚|搞笑
    • 影片类型
    • └ duration
    • Number
    • 120
    • 影片时长
    • └ description
    • String
    • ...
    • 剧情简介
    • └ open_day
    • Date
    • 2023-11-23 00:00:00
    • 上映时间 (有逻辑、
    • └ open_time
    • String
    • 2023-11-23 00:00:00
    • 上映时间(中文)
    • └ jump_url
    • String
    • http://xxxx
    • 影片详情页跳转链接
    • └ status
    • String
    • NORMAL
    • 影片状态(NORMAL--"购票";PRE -- "预售")
    count Number 350 总数
    return_message String 接口错误信息
    return_code String 0 接口通信Code(非0代表异常)

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    FilmOpenShowNowandsoonGetViiRequest req = new FilmOpenShowNowandsoonGetViiRequest();
    req.setPlatform(0L);
    req.setPageIndex(0L);
    req.setPageSize(10L);
    FilmOpenShowNowandsoonGetViiResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <film_open_show_nowandsoon_get_vii_response>
        <return_value>
            <show>
                <show_id>123</show_id>
                <show_name>大闹天宫</show_name>
                <poster>http://xxx/i1/O1CN01Z8X9vL1VWKHSFmVkb_!!6000000002660-0-alipicbeacon.jpg</poster>
                <score>9.1</score>
                <score_count>9999</score_count>
                <want_count>1000</want_count>
                <director>张艺谋</director>
                <leading_role>刘德华</leading_role>
                <type>惊悚|搞笑</type>
                <duration>120</duration>
                <description>...</description>
                <open_day>2023-11-23 00:00:00</open_day>
                <open_time>2023-11-23 00:00:00</open_time>
                <jump_url>http://xxxx</jump_url>
                <status>NORMAL</status>
            </show>
        </return_value>
        <count>350</count>
        <return_message>空</return_message>
        <return_code>0</return_code>
    </film_open_show_nowandsoon_get_vii_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

    返回
    顶部