淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
event_id	String	必须	1380002011588		麦座场次id
stand_id	String	可选	6672720012		看台id；场次关联场馆为大场馆时必选，大场馆必须通过(场次+看台)获取座位商品列表

名称	类型	示例值	描述
result	ResultData		api返回结果
└ msg String 成功提示 └ code String 200 状态码 data SeatInfoVO 座位信息 seat_list SeatVO [] 座位列表 └ seat_id String 121418831233 座位id └ price_id String 3288377313 单票票档id └ seat_group_id String 1298381993 固定座位组合id；例如 1排1座与1排2座为一个固定座位组合；同一座位组合中的座位必须同时购买 └ package_price_id String 9387461233 套票票档id；套票时必传 └ floor_name String 一楼楼层名称，例：1/一楼 └ row_name String 1排排名称，例：1排 └ seat_name String 2号座位号名称，例：2号 └ x String 726.938 横坐标-x，相对于场馆底图左上角的坐标 └ y String 364.233 纵坐标-y，相对于场馆底图左上角的坐标 └ seat_state Number 1 座位状态；1=可售，2=不可售 └ stand_name String 1区看台名称，例：1区 └ stand_id String 40782 看台id └ seat_no Number 2 座位号，例：2 └ row_no Number 1 排号，例：1 └ floor_no Number 1 楼层号，例：1 └ unique_column_no Number 20 座位在全场中的列号，例：20； └ unique_row_no Number 3 座位在全场中的排号，例：3；全场排号+全场列号唯一定位一个座位； seat_lock_info SeatLockInfo 座位锁座信息；座位锁票状态=1=已锁票时此对象不为空； └ 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；非空，一般为锁票操作时间； └ lock_mark String xxx 锁票备注；可空 └ lock_type_name String xx分销商预留锁票类型名称；可自定义，如xx分销商预留 └ lock_type_id Number 132131341 锁票类型id； └ lock_level_name String 1 锁票级别名称；可定义，如1、2、3级 └ lock_level_id Number 32143243 锁票级别id； └ operator_name String xiaoli 操作员名称 └ user_info String xxx 大客户/会员信息，格式为：名称/联系方式 └ seat_lock_state Number 1 座位锁票状态；1=已锁票，2=未锁票； └ venue_seat_id String 121418831233 座位模板对应的座位id;不同场次可以绑定相同的座位模板 └ event_id String 1380002011588 麦座场次id └ success Boolean true api请求是否成功

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzSeatListRequest req = new AlibabaDamaiMzSeatListRequest();
req.setEventId("1380002011588");
req.setStandId("6672720012");
AlibabaDamaiMzSeatListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMzSeatListRequest req = new AlibabaDamaiMzSeatListRequest();
req.EventId = "1380002011588";
req.StandId = "6672720012";
AlibabaDamaiMzSeatListResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMzSeatListRequest;
$req->setEventId("1380002011588");
$req->setStandId("6672720012");
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.damai.mz.seat.list' \
-d 'partner_id=apidoc' \
-d 'sign=60458AE6F1C83B50C18F49BED9C0AD89' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-11-01+04%3A30%3A31' \
-d 'v=2.0' \
-d 'event_id=1380002011588' \
-d 'stand_id=6672720012'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaDamaiMzSeatListRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.event_id="1380002011588"
req.stand_id="6672720012"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.damai.mz.seat.list");
add_param(pRequest,"event_id","1380002011588");
add_param(pRequest,"stand_id","6672720012");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.damai.mz.seat.list', {
	'event_id':'1380002011588',
	'stand_id':'6672720012'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_mz_seat_list_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <seat_list>
                <seat_v_o>
                    <seat_id>121418831233</seat_id>
                    <price_id>3288377313</price_id>
                    <seat_group_id>1298381993</seat_group_id>
                    <package_price_id>9387461233</package_price_id>
                    <floor_name>一楼</floor_name>
                    <row_name>1排</row_name>
                    <seat_name>2号</seat_name>
                    <x>726.938</x>
                    <y>364.233</y>
                    <seat_state>1</seat_state>
                    <stand_name>1区</stand_name>
                    <stand_id>40782</stand_id>
                    <seat_lock_info>
                        <lock_end_time>yyyy-MM-dd HH:mm</lock_end_time>
                        <lock_start_time>yyyy-MM-dd HH:mm</lock_start_time>
                        <lock_mark>xxx</lock_mark>
                        <lock_type_name>xx分销商预留</lock_type_name>
                        <lock_type_id>132131341</lock_type_id>
                        <lock_level_name>1</lock_level_name>
                        <lock_level_id>32143243</lock_level_id>
                        <operator_name>xiaoli</operator_name>
                        <user_info>xxx</user_info>
                    </seat_lock_info>
                    <seat_lock_state>1</seat_lock_state>
                    <venue_seat_id>121418831233</venue_seat_id>
                </seat_v_o>
            </seat_list>
            <event_id>1380002011588</event_id>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_seat_list_response>

{
    "alibaba_damai_mz_seat_list_response":{
        "result":{
            "msg":"成功",
            "code":"200",
            "data":{
                "seat_list":{
                    "seat_v_o":[
                        {
                            "seat_id":"121418831233",
                            "price_id":"3288377313",
                            "seat_group_id":"1298381993",
                            "package_price_id":"9387461233",
                            "floor_name":"一楼",
                            "row_name":"1排",
                            "seat_name":"2号",
                            "x":"726.938",
                            "y":"364.233",
                            "seat_state":1,
                            "stand_name":"1区",
                            "stand_id":"40782",
                            "seat_lock_info":{
                                "lock_end_time":"yyyy-MM-dd HH:mm",
                                "lock_start_time":"yyyy-MM-dd HH:mm",
                                "lock_mark":"xxx",
                                "lock_type_name":"xx分销商预留",
                                "lock_type_id":132131341,
                                "lock_level_name":"1",
                                "lock_level_id":32143243,
                                "operator_name":"xiaoli",
                                "user_info":"xxx"
                            },
                            "seat_lock_state":1,
                            "venue_seat_id":"121418831233"
                        }
                    ]
                },
                "event_id":"1380002011588"
            },
            "success":true
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

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

API测试工具错误码查询工具 SDK下载

开放平台

麦座API

alibaba.damai.mz.seat.list (选座项目-座位列表API)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ