文档中心 > API类目 > 电影票API

taobao.film.data.third.party.hotshows.get (热映影片列表)

购票能力输出-金保证获取淘票票热映影片列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_id Number 必须 12345 淘宝账号id
city_code Number 必须 310100 城市编码
platform Number 必须 2 平台
params Json 可选 {"":""} 扩展参数

响应参数

名称 类型 示例值 描述
result ResultListModel result result
  • └ return_code
  • String
  • 0
  • returnCode
  • return_value
  • HotShow
  • Show
  • returnValue
  • hot_shows
  • Show []
  • hotShows
  • hotShows
  • └ background_picture
  • String
  • xxx.jpg
  • 背景图
  • └ highlight
  • String
  • 尿点十足
  • 精彩点评
  • └ open_time
  • String
  • 2017-09-09
  • 首映日期格式:YYYY-MM-DD,YYYY-MM,已废弃
  • └ show_version_list
  • String []
  • 3D
  • 影片类型,内容如:2D、IMAX3D、3D、IMAX、剧情、其他等
  • └ show_mark
  • String
  • IMAX
  • (IMAX 3D>巨幕3D>IMAX>巨幕>4D>3D)
  • └ description
  • String
  • 描述
  • 简介
  • └ poster
  • String
  • xxx.jpg
  • 海报,影片等资源API,海报信息拼接规则如下: 第一部分:https://gw.alicdn.com/tfscom/ cdn域名拼接 第二部分:热映接口返回"poster": "i1/TB1iRSWSXXXXXcVXFXXXXXXXXXX_.jpg" 第三部分:控制图片大小_80x80.jpg 完整示例https://gw.alicdn.com/tfscom/i1/TB1iRSWSXXXXXcVXFXXXXXXXXXX_.jpg_80x80.jpg
  • └ trailer_list
  • String []
  • xxx.jpg
  • 剧照
  • └ open_day
  • String
  • 2017-09-09 00:00:00
  • 首映日期格式:YYYY-MM-DD HH:MM:SS,大于当前时间就是预售,小于等于当前日期就是在映影片。热映列表的影片全都可以购票,如果是在映的,现在就可以去影院观影,如果是预售,要等上映后才能去影院观影,相当于提前购票
  • └ duration
  • Number
  • 123
  • 放映时长
  • └ language
  • String
  • Chinese
  • 对白语言(语言版本仅供参考,一切以排期接口获取的语言为准)
  • └ country
  • String
  • 中国
  • 国家
  • └ type
  • String
  • 惊悚
  • 影片类型
  • └ leading_role
  • String
  • 李连杰
  • 主演
  • └ director
  • String
  • 刘德华
  • 导演
  • └ show_name_en
  • String
  • liudehua
  • 影片英文名
  • └ show_name
  • String
  • 惊声尖笑
  • 影片名称
  • └ id
  • Number
  • 12345
  • 影片id
  • └ remark
  • String
  • 9.7
  • 评分
  • └ features
  • String
  • {"":""}
  • 扩展参数,暂无含义,含义请联系淘票票技术
  • └ want_count
  • Number
  • 10000
  • 影片想看数
  • └ return_message
  • String
  • returnMessage
  • returnMessage

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmDataThirdPartyHotshowsGetRequest req = new FilmDataThirdPartyHotshowsGetRequest();
req.setUserId(12345L);
req.setCityCode(310100L);
req.setPlatform(2L);
req.setParamsString("{\"\":\"\"}");
FilmDataThirdPartyHotshowsGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_data_third_party_hotshows_get_response>
    <result>
        <return_code>0</return_code>
        <return_value>
            <hot_shows>
                <show>
                    <background_picture>xxx.jpg</background_picture>
                    <highlight>尿点十足</highlight>
                    <open_time>2017-09-09</open_time>
                    <show_version_list>
                        <string>3D</string>
                    </show_version_list>
                    <show_mark>IMAX</show_mark>
                    <description>描述</description>
                    <poster>xxx.jpg</poster>
                    <trailer_list>
                        <string>xxx.jpg</string>
                    </trailer_list>
                    <open_day>2017-09-09 00:00:00</open_day>
                    <duration>123</duration>
                    <language>Chinese</language>
                    <country>中国</country>
                    <type>惊悚</type>
                    <leading_role>李连杰</leading_role>
                    <director>刘德华</director>
                    <show_name_en>liudehua</show_name_en>
                    <show_name>惊声尖笑</show_name>
                    <id>12345</id>
                    <remark>9.7</remark>
                    <features>{&quot;&quot;:&quot;&quot;}</features>
                    <want_count>10000</want_count>
                </show>
            </hot_shows>
        </return_value>
        <return_message>returnMessage</return_message>
    </result>
</film_data_third_party_hotshows_get_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>

错误码解释

错误码 错误描述 解决方案
40002 非法参数 检查入参
13004 热映影片查询出错 联系接口人

API工具

如何获得此API

FAQ

返回
顶部