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

taobao.film.data.third.party.cinemas.get (购票能力输出-查询影院列表)

购票能力输出-查询影院列表,只返回基本的影院信息

公共参数

请求参数

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

响应参数

名称 类型 示例值 描述
result ResultGeneralModel result result
  • └ return_code
  • String
  • 0
  • returnCode
  • return_value
  • MtopCinemaList
  • MtopCinemaList
  • returnValue
  • mtop_cinemas
  • MtopCinema []
  • mtopCinemas
  • mtopCinemas
  • └ phone
  • String
  • 0571-xxxxx,111 0577-ccc,222
  • 多个号码,逗号后面是分机号,用空格分割
  • └ city_id
  • Number
  • 12345
  • 影院所属城市id
  • └ schedule_close_time
  • Number
  • 15
  • 影院场次提前关闭时间,单位分钟
  • └ latitude
  • String
  • 120.1
  • 影院纬度
  • └ longitude
  • String
  • 30.1
  • 影院经度
  • └ region_name
  • String
  • 西湖区
  • 影院所属区域名
  • └ cinema_name
  • String
  • 上海大光明
  • 影院名称
  • └ address
  • String
  • 南京东路
  • 地址
  • └ id
  • Number
  • 12345
  • 影院id
  • └ standard_id
  • String
  • 42112601
  • 广电总局发放给影院的8位标准影院编码
  • └ support_third_party_refund
  • Boolean
  • true
  • supportThirdPartyRefund
  • └ supports
  • String
  • "[{\"code\":1,\"desc\":\"临街收费停车位\",\"name\":\"可停车\",\"support\":true}]"
  • 服务
  • └ notice
  • String
  • "影城禁止携带宠物"
  • 公告
  • └ mall
  • String
  • {"776":{"中关村":"北京市北京市海淀区"},"18406":{"北下关":"北京市北京市海淀区"},"27316":{"双榆树":"北京市北京市海淀区"},"29622":{"人民大学":"北京市北京市海淀区"}}
  • 商圈
  • └ total_count
  • Number
  • 5
  • 城市的总页码数,1. 每页的影院数不一致,无上限;2. 可能出现空页面,但仍然需要依次把total_count里的每一页都请求一遍。入参page_index若小于total_count,则加1继续请求
  • └ return_message
  • String
  • success
  • returnMessage

请求示例

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

响应示例

  • XML示例
  • JSON示例
<film_data_third_party_cinemas_get_response>
    <result>
        <return_code>0</return_code>
        <return_value>
            <mtop_cinemas>
                <mtop_cinema>
                    <phone>0571-xxxxx,111 0577-ccc,222</phone>
                    <city_id>12345</city_id>
                    <schedule_close_time>15</schedule_close_time>
                    <latitude>120.1</latitude>
                    <longitude>30.1</longitude>
                    <region_name>西湖区</region_name>
                    <cinema_name>上海大光明</cinema_name>
                    <address>南京东路</address>
                    <id>12345</id>
                    <standard_id>42112601</standard_id>
                    <support_third_party_refund>true</support_third_party_refund>
                    <supports>&quot;[{\&quot;code\&quot;:1,\&quot;desc\&quot;:\&quot;临街收费停车位\&quot;,\&quot;name\&quot;:\&quot;可停车\&quot;,\&quot;support\&quot;:true}]&quot;</supports>
                    <notice>&quot;影城禁止携带宠物&quot;</notice>
                    <mall>{&quot;776&quot;:{&quot;中关村&quot;:&quot;北京市北京市海淀区&quot;},&quot;18406&quot;:{&quot;北下关&quot;:&quot;北京市北京市海淀区&quot;},&quot;27316&quot;:{&quot;双榆树&quot;:&quot;北京市北京市海淀区&quot;},&quot;29622&quot;:{&quot;人民大学&quot;:&quot;北京市北京市海淀区&quot;}}</mall>
                </mtop_cinema>
            </mtop_cinemas>
            <total_count>5</total_count>
        </return_value>
        <return_message>success</return_message>
    </result>
</film_data_third_party_cinemas_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

返回
顶部