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

taobao.film.hotshows.get (热映影片查询)

热映影片数据同步给微博

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
city_code Number 必须 123 城市代码
platform Number 必须 123 平台
page_code String 可选 ALIPAY 标识请求页面的相关参数
page_size Number 可选 20 分页大小
page_index Number 可选 1 分页页码

响应参数

名称 类型 示例值 描述
result GetHotShowsResult 热映影片输出给微博
  • hot_shows
  • Show []
  • []
  • 影片列表
  • └ accumulative_sales
  • String
  • demo
  • 累计票房(万元)
  • └ available_cinema_count
  • Number
  • 123
  • 可看影片数目
  • └ available_schedule_count
  • Number
  • 123
  • 可看排期数目
  • └ available_today_schedule_count
  • Number
  • 123
  • 今日可看排期数目
  • └ background_picture
  • String
  • demo
  • 背景图片
  • └ background_video
  • String
  • demo
  • 背景视频
  • └ cinema_count
  • Number
  • 123
  • 影片有多少影院在上映该片
  • └ comment
  • String
  • demo
  • 评论
  • └ country
  • String
  • demo
  • 国家
  • └ custom_poster
  • String
  • demo
  • 定制海报
  • └ description
  • String
  • demo
  • 简介
  • └ director
  • String
  • demo
  • 导演
  • └ distributor
  • String
  • demo
  • 发行商
  • └ duration
  • Number
  • 123
  • 片长(分钟)
  • └ edit_time
  • Date
  • 2015-08-11 14:57:14
  • 视频更新时间
  • └ flag
  • Number
  • 123
  • 影片标:热门影片
  • └ highlight
  • String
  • demo
  • 精彩点评
  • └ id
  • Number
  • 1001
  • 影片id
  • └ imdbid
  • String
  • demo
  • 国际标准影片id号
  • └ is_attention
  • Boolean
  • false
  • isAttention
  • └ is_remind
  • Boolean
  • false
  • 是否标记为上映提醒
  • └ is_want
  • Boolean
  • false
  • 是否标记为想看
  • └ language
  • String
  • demo
  • 对白语言
  • └ leading_role
  • String
  • demo
  • 主演
  • └ low_price
  • Number
  • 123
  • 影片兑换券对应的最低价格。单位 “分”
  • └ max_seat_price
  • Number
  • 123
  • 最高座位价格
  • └ min_seat_price
  • Number
  • 123
  • 最低座位价格
  • └ open_day
  • Date
  • 2015-08-11 14:57:15
  • 首映日期格式:YYYY-MM-DD
  • └ order_by
  • Number
  • 123
  • 排序
  • └ order_count
  • Number
  • 123
  • 影片订单数
  • └ platform
  • Number
  • 123
  • 不显示的平台
  • └ poster
  • String
  • demo
  • 海报
  • └ price
  • Number
  • 123
  • 额外记录影片价格,一般来源于场次。单位 “分”
  • └ recent_order_amount
  • Number
  • 123
  • 影片最近7天销售金额(分)
  • └ remark
  • String
  • demo
  • 评分
  • └ schedule_count
  • Number
  • 123
  • 上映该影片的场次数
  • └ show_mark
  • String
  • demo
  • (IMAX 3D>巨幕3D>IMAX>巨幕>4D>3D)
  • └ show_name
  • String
  • 霍比特人
  • 影片名称
  • └ show_name_en
  • String
  • demo
  • 电影英文名
  • └ show_version_list
  • String []
  • ["hello","world"]
  • 影片版本,例:2D
  • └ support_type
  • String
  • demo
  • 支持类型。(在线选座等)
  • └ trailer_list
  • String []
  • ["hello","world"]
  • 剧照,最多100张
  • └ type
  • String
  • demo
  • 类型
  • └ view_count
  • Number
  • 123
  • 浏览pv
  • └ want_count
  • Number
  • 123
  • 想看数
  • └ week_sales
  • String
  • demo
  • 周票房(万元)
  • └ worth_pct
  • String
  • demo
  • 值得看百分比,如78%
  • activities
  • Activity []
  • 活动信息
  • └ activity_tag
  • String
  • 元旦特惠
  • 活动标签,用于展示
  • └ support_dates
  • Number []
  • {"1234567","234567"}
  • 支持的日期,unix时间戳
  • └ activity_type
  • String
  • REDUCE
  • 活动类型,如REDUCE:立减
  • └ activity_ext_type
  • String
  • 2
  • 活动扩展标
  • └ is_activity_visible
  • Boolean
  • true
  • 该活动是否展示
  • └ activity_name
  • String
  • 新春红包立减5.8
  • 活动名称
  • └ activity_title
  • String
  • 新人8.8测试
  • 活动标题
  • └ description
  • String
  • 新人8.8测试
  • 活动描述
  • └ long_description
  • String
  • 这个活动规则是xxxx
  • 活动长描述
  • └ fantastic
  • String
  • 1
  • TOTAL_BOX_OFFICE(1<<0,"总票房最高"), TODAY_BOX_OFFICE(1<<1, "实时票房最高"), HIGHEST_REMARK(1<<2,"评分最高"), INTERNAL_RECOMMEND(1<<3, "特别推荐");
  • └ open_time
  • String
  • 2015
  • 上映时间
  • └ pre_schedule_dates
  • String []
  • 1458473640
  • preScheduleDates
  • └ koubei_h5_url
  • String
  • koubeiH5Url
  • └ alipay_koubei_h5_url
  • String
  • alipayKoubeiH5Url
  • └ sold_type
  • String
  • soldType
  • └ city_code
  • Number
  • 310100
  • 城市码
  • └ region_name
  • String
  • 上海
  • 地域名
  • └ preview_num
  • Number
  • 3
  • 预告片数量
  • previews
  • VideoItem []
  • demo
  • 预告片列表
  • └ title
  • String
  • title
  • 预告片标题
  • └ cover_url
  • String
  • cover
  • 视频封面url
  • └ video_id
  • Number
  • 123
  • 视频id
  • └ duration
  • Number
  • 100
  • 视频时长
  • └ web_url
  • String
  • url
  • 播放地址
  • └ ipad_url
  • String
  • ipadUrl
  • 播放地址
  • └ iphone_url
  • String
  • iphoneUrl
  • 播放地址
  • └ android_phone_url
  • String
  • androidUrl
  • 播放地址
  • └ result_code
  • String
  • demo
  • 返回结果码
  • └ result_msg
  • String
  • demo
  • 返回信息
  • └ success
  • Boolean
  • false
  • 是否成功
  • └ show_list_h5_url
  • String
  • showListH5Url
  • └ alipay_show_list_h5_url
  • String
  • alipayShowListH5Url

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmHotshowsGetRequest req = new FilmHotshowsGetRequest();
req.setCityCode(123L);
req.setPlatform(123L);
req.setPageCode("ALIPAY");
req.setPageSize(20L);
req.setPageIndex(1L);
FilmHotshowsGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_hotshows_get_response>
    <result>
        <hot_shows>
            <show>
                <accumulative_sales>demo</accumulative_sales>
                <available_cinema_count>123</available_cinema_count>
                <available_schedule_count>123</available_schedule_count>
                <available_today_schedule_count>123</available_today_schedule_count>
                <background_picture>demo</background_picture>
                <background_video>demo</background_video>
                <cinema_count>123</cinema_count>
                <comment>demo</comment>
                <country>demo</country>
                <custom_poster>demo</custom_poster>
                <description>demo</description>
                <director>demo</director>
                <distributor>demo</distributor>
                <duration>123</duration>
                <edit_time>2015-08-11 14:57:14</edit_time>
                <flag>123</flag>
                <highlight>demo</highlight>
                <id>1001</id>
                <imdbid>demo</imdbid>
                <is_attention>false</is_attention>
                <is_remind>false</is_remind>
                <is_want>false</is_want>
                <language>demo</language>
                <leading_role>demo</leading_role>
                <low_price>123</low_price>
                <max_seat_price>123</max_seat_price>
                <min_seat_price>123</min_seat_price>
                <open_day>2015-08-11 14:57:15</open_day>
                <order_by>123</order_by>
                <order_count>123</order_count>
                <platform>123</platform>
                <poster>demo</poster>
                <price>123</price>
                <recent_order_amount>123</recent_order_amount>
                <remark>demo</remark>
                <schedule_count>123</schedule_count>
                <show_mark>demo</show_mark>
                <show_name>霍比特人</show_name>
                <show_name_en>demo</show_name_en>
                <show_version_list>
                    <string>[&quot;hello&quot;</string>
                    <string>&quot;world&quot;]</string>
                </show_version_list>
                <support_type>demo</support_type>
                <trailer_list>
                    <string>[&quot;hello&quot;</string>
                    <string>&quot;world&quot;]</string>
                </trailer_list>
                <type>demo</type>
                <view_count>123</view_count>
                <want_count>123</want_count>
                <week_sales>demo</week_sales>
                <worth_pct>demo</worth_pct>
                <activities>
                    <activity>
                        <activity_tag>元旦特惠</activity_tag>
                        <support_dates>
                            <number>{&quot;1234567&quot;</number>
                            <number>&quot;234567&quot;}</number>
                        </support_dates>
                        <activity_type>REDUCE</activity_type>
                        <activity_ext_type>2</activity_ext_type>
                        <is_activity_visible>true</is_activity_visible>
                        <activity_name>新春红包立减5.8</activity_name>
                        <activity_title>新人8.8测试</activity_title>
                        <description>新人8.8测试</description>
                        <long_description>这个活动规则是xxxx</long_description>
                    </activity>
                </activities>
                <fantastic>1</fantastic>
                <open_time>2015</open_time>
                <pre_schedule_dates>
                    <string>1458473640</string>
                </pre_schedule_dates>
                <koubei_h5_url></koubei_h5_url>
                <alipay_koubei_h5_url></alipay_koubei_h5_url>
                <sold_type></sold_type>
                <city_code>310100</city_code>
                <region_name>上海</region_name>
                <preview_num>3</preview_num>
                <previews>
                    <video_item>
                        <title>title</title>
                        <cover_url>cover</cover_url>
                        <video_id>123</video_id>
                        <duration>100</duration>
                        <web_url>url</web_url>
                        <ipad_url>ipadUrl</ipad_url>
                        <iphone_url>iphoneUrl</iphone_url>
                        <android_phone_url>androidUrl</android_phone_url>
                    </video_item>
                </previews>
            </show>
        </hot_shows>
        <result_code>demo</result_code>
        <result_msg>demo</result_msg>
        <success>false</success>
        <show_list_h5_url></show_list_h5_url>
        <alipay_show_list_h5_url></alipay_show_list_h5_url>
    </result>
</film_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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部