alibaba.damai.mz.seat.state.list (选座项目-座位状态API)

选座项目-座位状态API; 1、项目为选座项目时,根据(场次id+看台id)或(场次id+座位ids)获取 座位状态列表; 2、此为高性能API,用户下单或点选某个座位时,可以根据(场次id+座位ids)调用此API获取实时座位状态,提高下单成功率。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param SeatStateListParam 必须 座位状态列表入参
  • └ event_id
  • String
  • 必须
  • 1380002011588
  • 麦座场次id;不能只传场次id获取座位状态列表
  • └ stand_id
  • String
  • 可选
  • 344912340023
  • 看台id;可通过(场次id+看台id)获取座位状态列表
  • └ seat_id_list
  • String []
  • 可选
  • 7937126381,68312356632
  • 座位ids;传座位ids时可不传standId,一般获取少量座位状态时使用;数量<=20

响应参数

名称 类型 示例值 描述
result ResultData api返回结果
  • └ msg
  • String
  • 成功
  • 提示
  • └ code
  • String
  • 200
  • 状态码
  • data
  • SeatStateInfoVO
  • 座位状态信息
  • └ event_id
  • String
  • 1380002011588
  • 场次id
  • seat_state_list
  • SeatStateVO []
  • 座位状态信息列表
  • └ seat_state
  • Number
  • 1
  • 座位状态;1=可售,2=不可售
  • └ seat_id
  • String
  • 2983199231
  • 座位id
  • └ seat_lock_state
  • Number
  • 1
  • 座位锁票状态;1=已锁票,2=未锁票;
  • seat_lock_info
  • SeatLockInfo
  • 座位锁座信息;座位锁票状态=1=已锁票 时此对象不为空;
  • └ operator_name
  • String
  • xiaoli
  • 操作员名称
  • └ lock_end_time
  • String
  • yyyy-MM-dd HH:mm
  • 锁票截止时间;格式:yyyy-MM-dd HH:mm;可空,为null或空时说明锁票长期有效;
  • └ lock_start_time
  • String
  • yyyy-MM-dd HH:mm
  • 锁票开始时间;格式:yyyy-MM-dd HH:mm;非空,一般为锁票操作时间;
  • └ user_info
  • String
  • xxx
  • 大客户/会员信息,格式为:名称/联系方式
  • └ lock_mark
  • String
  • xxx
  • 锁票备注;可空
  • └ lock_type_name
  • String
  • xx分销商预留
  • 锁票类型名称;可自定义,如xx分销商预留
  • └ lock_type_id
  • Number
  • 13123211
  • 锁票类型id;
  • └ lock_level_name
  • String
  • 1
  • 锁票级别名称;可定义,如1、2、3级
  • └ lock_level_id
  • Number
  • 3213211
  • 锁票级别id;
  • └ success
  • Boolean
  • true
  • api请求是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzSeatStateListRequest req = new AlibabaDamaiMzSeatStateListRequest();
AlibabaDamaiMzSeatStateListRequest.SeatStateListParam obj1 = new AlibabaDamaiMzSeatStateListRequest.SeatStateListParam();
obj1.setEventId("1380002011588");
obj1.setStandId("344912340023");
obj1.setSeatIdList("7937126381,68312356632");
req.setParam(obj1);
AlibabaDamaiMzSeatStateListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_seat_state_list_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <event_id>1380002011588</event_id>
            <seat_state_list>
                <seat_state_v_o>
                    <seat_state>1</seat_state>
                    <seat_id>2983199231</seat_id>
                    <seat_lock_state>1</seat_lock_state>
                    <seat_lock_info>
                        <operator_name>xiaoli</operator_name>
                        <lock_end_time>yyyy-MM-dd HH:mm</lock_end_time>
                        <lock_start_time>yyyy-MM-dd HH:mm</lock_start_time>
                        <user_info>xxx</user_info>
                        <lock_mark>xxx</lock_mark>
                        <lock_type_name>xx分销商预留</lock_type_name>
                        <lock_type_id>13123211</lock_type_id>
                        <lock_level_name>1</lock_level_name>
                        <lock_level_id>3213211</lock_level_id>
                    </seat_lock_info>
                </seat_state_v_o>
            </seat_state_list>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_seat_state_list_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>

错误码解释

错误码 错误描述 解决方案
40100000 api未知错误 通用系统异常
40100001 api请求失败 通用业务异常
40100002 请求必须的参数不能为空 请求必须的参数不能为空
40100003 请求数据不存在 请求数据不存在
40100004 非法的appkey,请联系麦座小二 非法的appkey,请联系麦座小二
40100007 appkey商户配置不存在,请联系麦座小二 appkey商户配置不存在,请联系麦座小二
40100008 出参数据不符合规范,请联系麦座小二 出参数据不符合规范,请联系麦座小二
40100009 接口超时,请稍后重试 接口超时,请稍后重试
61001002 数据不存在 数据不存在
61001003 参数非法 参数非法
61001006 分销渠道未授权 分销渠道未授权
61001008 网站渠道未授权 网站渠道未授权
61004001 场次未开售 场次未开售

API工具

如何获得此API

FAQ

返回
顶部