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

taobao.film.cinemaschedule.get (影院场次接口)

提供淘宝电影的场次相关信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_id Number 可选 181210393 用户淘宝id
cinema_id Number 必须 130735 影院id
activity_id Number 可选 123 活动id,没有特殊要求不要传
show_id Number 可选 123 影片id, 没有特殊要求可以不传
platform Number 可选 2 平台标识
city_code Number 可选 310100 城市码,可不传
params Json 可选 {} 扩展参数

响应参数

名称 类型 示例值 描述
result ResultGeneralModel 系统自动生成
  • └ return_code
  • String
  • 0
  • 返回成功
  • return_value
  • MtopCinema
  • 返回值
  • └ id
  • Number
  • 1234
  • 影院id
  • └ address
  • String
  • 西湖区黄龙时代
  • 影院地址
  • └ cinema_name
  • String
  • 翠苑电影大世界
  • 影院名称
  • └ region_name
  • String
  • 西湖区
  • 区域名称
  • └ longitude
  • String
  • 12.12
  • 纬度
  • └ latitude
  • String
  • 12.12
  • 经度
  • └ schedule_close_time
  • Number
  • 15
  • 开场前多少分钟排期关闭售卖
  • activities
  • MtopActivity []
  • 活动
  • └ id
  • Number
  • 123456
  • 活动id
  • └ ori_activity_id
  • Number
  • 1234
  • 活动初始id
  • └ activity_type
  • String
  • 活动类型
  • └ activity_price
  • Number
  • 500
  • 活动优惠的价格, 单位分
  • └ promotion_price
  • Number
  • 3500
  • 影院排期的活动最优价格, 单位分
  • └ activity_ext_type
  • Number
  • 4
  • 活动外部类型: FCODE(1, "预售"), HUIJIN(2, "实时扣减"), COUPON(3, "代金券"), SALES(4, "卖品"), TUAN(5, "团购")
  • └ activity_tag
  • String
  • 美国队长大优惠
  • 活动标
  • └ support_date
  • Number
  • 1460563200
  • 支持日期
  • └ is_activity_visible
  • Boolean
  • true
  • 活动是否可见
  • └ activity_ext_tag_map
  • String
  • {key:value,key:value}
  • 各页面活动标
  • └ activity_title
  • String
  • 美国队长搞活动
  • 活动标题
  • └ long_description
  • String
  • 这是一个美国队长的活动,blablabla
  • 活动长描述
  • └ join_count
  • Number
  • 0
  • 用户已参加几次活动
  • └ join_limit
  • Number
  • 0
  • 用户能参加几次活动
  • └ available_schedule_count
  • Number
  • 20
  • 排期数
  • └ available_today_schedule_count
  • Number
  • 10
  • 今天排期数
  • └ special_flag
  • Number
  • 12
  • 支持特色
  • └ support_f_lag
  • Number
  • 3
  • 影院特殊标,如支持在线选座等。
  • shows
  • Show []
  • 影片列表
  • schedules
  • Schedule []
  • 排期列表
  • └ id
  • Number
  • 123
  • 排期id
  • └ show_time
  • Date
  • 2016-04-06 12:00:00
  • 排期开始时间
  • └ show_version
  • String
  • 3D
  • 影片类型
  • └ hall_name
  • String
  • 9号厅
  • 厅名称
  • └ service_fee
  • Number
  • 100
  • 服务费,单位为分
  • └ partner_code
  • String
  • wanda
  • 合作商名称
  • └ show_date
  • String
  • 2016-04-06
  • 排期日期
  • └ price
  • Number
  • 4200
  • 价格,单位分
  • └ is_expired
  • Boolean
  • false
  • 排期是否过期
  • └ flag
  • Number
  • 12
  • 排期标志位
  • partners
  • SchedulePartner []
  • 合作商信息,list中只会有一个
  • └ ext_id
  • String
  • 1234
  • 外部排期id
  • └ show_ext_id
  • String
  • 12345
  • 外部影片id
  • └ cinema_ext_id
  • String
  • 123456
  • 外部影院id
  • └ id
  • String
  • 123
  • 排期id
  • └ cinema_price
  • Number
  • 4200
  • 影院价格,单位分
  • └ promotion_price
  • Number
  • 3800
  • 营销价格,单位分
  • └ price
  • Number
  • 4200
  • 价格,单位分
  • └ trade_price
  • Number
  • 4200
  • 交易价格,单位分
  • └ service_fee
  • Number
  • 100
  • 服务费,单位分
  • └ partner_code
  • String
  • wanda
  • 合作商code
  • └ partner_name
  • String
  • 万达
  • 合作商名称
  • └ max_can_buy
  • Number
  • 4
  • 场次最多可购买数
  • └ partner_max_can_buy
  • Number
  • 5
  • 合作商最多可购买数
  • └ sold_count
  • Number
  • 10
  • 卖出座位数
  • └ seat_count
  • Number
  • 50
  • 总座位数
  • activities
  • Activity []
  • 活动信息
  • └ id
  • Number
  • 123
  • 活动id
  • └ ori_activity_id
  • Number
  • 1234
  • 初始活动id
  • └ activity_tag
  • String
  • 美国队长3大优惠
  • 活动标
  • └ activity_ext_type
  • Number
  • 2
  • 外部活动类型
  • └ titles
  • String []
  • {[今天]}
  • 场次标题
  • └ schedule_refundable
  • Boolean
  • false
  • 场次是否支持退款
  • └ schedule_status
  • String
  • APPROVING
  • 场次状态,APPROVING为可售卖,EXCEPTION和NORMAL不可售卖
  • activities
  • Activity []
  • {}
  • 活动信息
  • └ id
  • Number
  • 123
  • 活动id
  • └ ori_activity_id
  • Number
  • 1234
  • 初始活动id
  • └ activity_tag
  • String
  • 美国队长3大优惠
  • 活动标
  • └ activity_ext_type
  • Number
  • 2
  • 外部活动类型
  • └ wanda_jump_url
  • String
  • http://xxx.xx
  • 万达跳转url
  • special_schedules
  • SpecialSchedules []
  • 特殊场次
  • └ title
  • String
  • 标题
  • 标题
  • └ long_tile
  • String
  • 长标题
  • 长标题
  • └ tag
  • String
  • 范冰冰见面会
  • 特殊场次标
  • └ description
  • String
  • 这是一个明星见面会的描述
  • 描述
  • └ id
  • Number
  • 1234
  • 影片id
  • └ show_name
  • String
  • 美国队长
  • 影片名称
  • └ poster
  • String
  • xxxx.url
  • 海报地址
  • └ show_mark
  • String
  • 4.5
  • 影片评分
  • └ want_count
  • Number
  • 123123
  • 想看人数
  • └ duration
  • Number
  • 125
  • 影片片场,单位分钟
  • └ remark
  • String
  • 5.6
  • 影片评分
  • └ pre_schedule_dates
  • String []
  • 1345678976
  • preScheduleDates
  • └ always_g_o
  • Boolean
  • true
  • 是否是常去影院,传userId后会有值
  • cinema_phones
  • Phone []
  • 影院电话
  • └ area_code
  • String
  • 010
  • 区域号
  • └ phone_number
  • String
  • 87986574
  • 电话号码
  • └ extension_number
  • String
  • 01
  • 扩展好
  • └ phone_string
  • String
  • 010-87986574-01
  • 影院电话字符串
  • └ descrption
  • String
  • 这个一个影院描述
  • 影院描述
  • └ bus_line
  • String
  • 12路车,8路车
  • 公交信息
  • └ lock_seat_time
  • Number
  • 15
  • 锁座最长时间
  • support_list
  • CinemaSupport []
  • 影院特色信息
  • └ code
  • Number
  • 1
  • 特色码
  • └ desc
  • String
  • 3D眼镜
  • 特色描述
  • └ support
  • Boolean
  • true
  • 是否支持
  • └ cinema_detail_url
  • String
  • xxx.url
  • 影院详情h5页面地址
  • └ near_facility
  • String
  • 附近设施
  • 附近设施
  • └ return_message
  • String
  • 系统异常
  • 返回的错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmCinemascheduleGetRequest req = new FilmCinemascheduleGetRequest();
req.setUserId(181210393L);
req.setCinemaId(130735L);
req.setActivityId(123L);
req.setShowId(123L);
req.setPlatform(2L);
req.setCityCode(310100L);
req.setParamsString("{}");
FilmCinemascheduleGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_cinemaschedule_get_response>
    <result>
        <return_code>0</return_code>
        <return_value>
            <id>1234</id>
            <address>西湖区黄龙时代</address>
            <cinema_name>翠苑电影大世界</cinema_name>
            <region_name>西湖区</region_name>
            <longitude>12.12</longitude>
            <latitude>12.12</latitude>
            <schedule_close_time>15</schedule_close_time>
            <activities>
                <mtop_activity>
                    <id>123456</id>
                    <ori_activity_id>1234</ori_activity_id>
                    <activity_type>无</activity_type>
                    <activity_price>500</activity_price>
                    <promotion_price>3500</promotion_price>
                    <activity_ext_type>4</activity_ext_type>
                    <activity_tag>美国队长大优惠</activity_tag>
                    <support_date>1460563200</support_date>
                    <is_activity_visible>true</is_activity_visible>
                    <activity_ext_tag_map>{key:value,key:value}</activity_ext_tag_map>
                    <activity_title>美国队长搞活动</activity_title>
                    <long_description>这是一个美国队长的活动,blablabla</long_description>
                    <join_count>0</join_count>
                    <join_limit>0</join_limit>
                </mtop_activity>
            </activities>
            <available_schedule_count>20</available_schedule_count>
            <available_today_schedule_count>10</available_today_schedule_count>
            <special_flag>12</special_flag>
            <support_f_lag>3</support_f_lag>
            <shows>
                <show>
                    <schedules>
                        <schedule>
                            <id>123</id>
                            <show_time>2016-04-06 12:00:00</show_time>
                            <show_version>3D</show_version>
                            <hall_name>9号厅</hall_name>
                            <service_fee>100</service_fee>
                            <partner_code>wanda</partner_code>
                            <show_date>2016-04-06</show_date>
                            <price>4200</price>
                            <is_expired>false</is_expired>
                            <flag>12</flag>
                            <partners>
                                <schedule_partner>
                                    <ext_id>1234</ext_id>
                                    <show_ext_id>12345</show_ext_id>
                                    <cinema_ext_id>123456</cinema_ext_id>
                                    <id>123</id>
                                    <cinema_price>4200</cinema_price>
                                    <promotion_price>3800</promotion_price>
                                    <price>4200</price>
                                    <trade_price>4200</trade_price>
                                    <service_fee>100</service_fee>
                                    <partner_code>wanda</partner_code>
                                    <partner_name>万达</partner_name>
                                    <max_can_buy>4</max_can_buy>
                                    <partner_max_can_buy>5</partner_max_can_buy>
                                    <sold_count>10</sold_count>
                                    <seat_count>50</seat_count>
                                    <activities>
                                        <activity>
                                            <id>123</id>
                                            <ori_activity_id>1234</ori_activity_id>
                                            <activity_tag>美国队长3大优惠</activity_tag>
                                            <activity_ext_type>2</activity_ext_type>
                                        </activity>
                                    </activities>
                                </schedule_partner>
                            </partners>
                            <titles>
                                <string>{[今天]}</string>
                            </titles>
                            <schedule_refundable>false</schedule_refundable>
                            <schedule_status>APPROVING</schedule_status>
                            <activities>
                                <activity>
                                    <id>123</id>
                                    <ori_activity_id>1234</ori_activity_id>
                                    <activity_tag>美国队长3大优惠</activity_tag>
                                    <activity_ext_type>2</activity_ext_type>
                                </activity>
                            </activities>
                            <wanda_jump_url>http://xxx.xx</wanda_jump_url>
                            <special_schedules>
                                <special_schedules>
                                    <title>标题</title>
                                    <long_tile>长标题</long_tile>
                                    <tag>范冰冰见面会</tag>
                                    <description>这是一个明星见面会的描述</description>
                                </special_schedules>
                            </special_schedules>
                        </schedule>
                    </schedules>
                    <id>1234</id>
                    <show_name>美国队长</show_name>
                    <poster>xxxx.url</poster>
                    <show_mark>4.5</show_mark>
                    <want_count>123123</want_count>
                    <duration>125</duration>
                    <remark>5.6</remark>
                    <pre_schedule_dates>
                        <string>1345678976</string>
                    </pre_schedule_dates>
                </show>
            </shows>
            <always_g_o>true</always_g_o>
            <cinema_phones>
                <phone>
                    <area_code>010</area_code>
                    <phone_number>87986574</phone_number>
                    <extension_number>01</extension_number>
                    <phone_string>010-87986574-01</phone_string>
                </phone>
            </cinema_phones>
            <descrption>这个一个影院描述</descrption>
            <bus_line>12路车,8路车</bus_line>
            <lock_seat_time>15</lock_seat_time>
            <support_list>
                <cinema_support>
                    <code>1</code>
                    <desc>3D眼镜</desc>
                    <support>true</support>
                </cinema_support>
            </support_list>
            <cinema_detail_url>xxx.url</cinema_detail_url>
            <near_facility>附近设施</near_facility>
        </return_value>
        <return_message>系统异常</return_message>
    </result>
</film_cinemaschedule_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

返回
顶部