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

taobao.film.tfseats.data.seat.query (影院影厅座位图查询)

根据影院专资办编码及影厅编码查询影厅座位图

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_seats_request QuerySeatsRequest 必须 查询座位图请求
  • └ hall_id
  • String
  • 可选
  • 00001
  • 影厅编码,不传则返回该影院所有影厅
  • └ standard_id
  • String
  • 必须
  • 12345678
  • 影院八位专资编码

响应参数

名称 类型 示例值 描述
result ResultGeneralModel 系统自动生成
  • return_values
  • CinemaHalls []
  • 返回值
  • regions
  • ZhongYingSeats []
  • 分区座位图列表
  • seats
  • SeatInfo []
  • 座位列表
  • └ status
  • String
  • SEAT_STATUS_SELL
  • 座位状态 SEAT_STATUS_SELL:可售,SEAT_STATUS_UNSELL:已出售,SEAT_STATUS_DELETE:不可售/无效座位,SEAT_STATUS_MANUAL_LOCK:影院锁定不可售
  • └ type
  • String
  • SEAT_FLAG_LOVE1
  • 座位类型 SEAT_FLAG_NORMAL:普通,SEAT_FLAG_LOVE1:情侣1,SEAT_FLAG_LOVE2:情侣2
  • └ row
  • String
  • 1
  • └ seat_name
  • String
  • 1排1座
  • 座位名称
  • └ row_name
  • String
  • 1
  • 行名称
  • └ seat_code
  • String
  • 001000000055-1-1
  • 座位编码
  • └ col
  • String
  • 1
  • └ area
  • String
  • 423
  • 分区ID,可能为空
  • └ section_id
  • String
  • 1000000055
  • 场区ID,可能为空
  • └ seat_size
  • Number
  • 100
  • 座位数量
  • └ region_id
  • String
  • 423
  • 分区ID,为内部seats中的area,可能为空
  • └ section_name
  • String
  • 默认场区
  • 场区名称,可能为空
  • └ hall_name
  • String
  • 情侣厅
  • 影厅名称
  • └ standard_id
  • String
  • 99999673
  • 影院专资办标准八位编码
  • └ hall_id
  • String
  • 0000000000000123
  • 影厅编码
  • └ return_code
  • String
  • 0
  • 返回值
  • └ timestamp
  • Number
  • 1627888425245
  • 时间戳
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FilmTfseatsDataSeatQueryRequest req = new FilmTfseatsDataSeatQueryRequest();
FilmTfseatsDataSeatQueryRequest.QuerySeatsRequest obj1 = new FilmTfseatsDataSeatQueryRequest.QuerySeatsRequest();
obj1.setHallId("00001");
obj1.setStandardId("12345678");
req.setQuerySeatsRequest(obj1);
FilmTfseatsDataSeatQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<film_tfseats_data_seat_query_response>
    <result>
        <return_values>
            <cinema_halls>
                <regions>
                    <zhong_ying_seats>
                        <seats>
                            <seat_info>
                                <status>SEAT_STATUS_SELL</status>
                                <type>SEAT_FLAG_LOVE1</type>
                                <row>1</row>
                                <seat_name>1排1座</seat_name>
                                <row_name>1</row_name>
                                <seat_code>001000000055-1-1</seat_code>
                                <col>1</col>
                                <area>423</area>
                            </seat_info>
                        </seats>
                        <section_id>1000000055</section_id>
                        <seat_size>100</seat_size>
                        <region_id>423</region_id>
                        <section_name>默认场区</section_name>
                    </zhong_ying_seats>
                </regions>
                <hall_name>情侣厅</hall_name>
                <standard_id>99999673</standard_id>
                <hall_id>0000000000000123</hall_id>
            </cinema_halls>
        </return_values>
        <return_code>0</return_code>
        <timestamp>1627888425245</timestamp>
        <success>true</success>
    </result>
</film_tfseats_data_seat_query_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

返回
顶部