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

taobao.film.data.third.party.soonshows.get (购票能力输出-即将上映影片)

购票能力输出-返回即将上映影片列表

公共参数

请求参数

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

响应参数

名称 类型 示例值 描述
result ResultListModel result result
  • └ return_code
  • String
  • 0
  • returnCode
  • return_value
  • SoonShow
  • Show
  • returnValue
  • soon_shows
  • Show []
  • soonShows
  • soonShows
  • └ background_picture
  • String
  • xxxx.jpg
  • 影片背景图
  • └ highlight
  • String
  • 尿点十足
  • 精彩点评
  • └ open_time
  • String
  • 2017-02-01
  • 上映时间,类型为YYYY、YYYY-MM、YYYY-MM-DD,结合open_day一起看,如果open_time只有YYYY或YYYY-MM,前者表示影片上映时间只确定年份,后者表示确定到月份,具体日期未定。对外展示仍以open_day为主
  • └ show_version_list
  • String []
  • 3D
  • 影片类型,内容如:2D、IMAX3D、3D、IMAX、剧情、其他等
  • └ show_mark
  • String
  • 英语3D
  • 影片版本
  • └ description
  • String
  • 描述
  • 影片简介
  • └ poster
  • String
  • xxxx.jpg
  • 海报
  • └ trailer_list
  • String []
  • xxxx.jpg
  • 剧照
  • └ open_day
  • String
  • 2017-02-01 12:00:00
  • 上映日期,格式YYYY-MM-DD HH:MM:SS,即将上映的影片买票后都不能直接去影院观影,要等影片上映后才能看。即将上映的影片是否能购票,要看拉取到的场次是否有关联这部影片,如果没有,则不能购票,如果影片关联了排期,就可以购票了。也就是预售。
  • └ duration
  • Number
  • 123
  • 影片播放时长
  • └ language
  • String
  • English
  • 对白语言(语言版本仅供参考,一切以排期接口获取的语言为准)
  • └ country
  • String
  • 英国
  • 国家
  • └ type
  • String
  • 惊悚
  • 影片类型
  • └ leading_role
  • String
  • 刘德华
  • 主演
  • └ director
  • String
  • 李连杰
  • 导演
  • └ show_name_en
  • String
  • 历险记
  • 影片英文名
  • └ show_name
  • String
  • 历险记
  • 影片名称
  • └ id
  • Number
  • 12345
  • 影片id
  • └ remark
  • String
  • 9.7
  • 评分
  • └ features
  • String
  • {"":""}
  • 扩展字段,含义请联系淘票票技术
  • └ want_count
  • Number
  • 2000
  • 影片想看数
  • └ return_message
  • String
  • success
  • returnMessage

请求示例

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

响应示例

  • XML示例
  • JSON示例
<film_data_third_party_soonshows_get_response>
    <result>
        <return_code>0</return_code>
        <return_value>
            <soon_shows>
                <show>
                    <background_picture>xxxx.jpg</background_picture>
                    <highlight>尿点十足</highlight>
                    <open_time>2017-02-01</open_time>
                    <show_version_list>
                        <string>3D</string>
                    </show_version_list>
                    <show_mark>英语3D</show_mark>
                    <description>描述</description>
                    <poster>xxxx.jpg</poster>
                    <trailer_list>
                        <string>xxxx.jpg</string>
                    </trailer_list>
                    <open_day>2017-02-01 12:00:00</open_day>
                    <duration>123</duration>
                    <language>English</language>
                    <country>英国</country>
                    <type>惊悚</type>
                    <leading_role>刘德华</leading_role>
                    <director>李连杰</director>
                    <show_name_en>历险记</show_name_en>
                    <show_name>历险记</show_name>
                    <id>12345</id>
                    <remark>9.7</remark>
                    <features>{&quot;&quot;:&quot;&quot;}</features>
                    <want_count>2000</want_count>
                </show>
            </soon_shows>
        </return_value>
        <return_message>success</return_message>
    </result>
</film_data_third_party_soonshows_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 非法参数 检查入参
13005 即将上映影片查询出错 联系接口人

API工具

如何获得此API

FAQ

返回
顶部