淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
param	EventListParam	必须			场次列表入参
└ project_id String 必须 6134001011588 麦座项目id └ event_id_list String [] 可选 717691815230,2836818415130 麦座场次ids；可查询一个项目下单个或几个场次的数据；限制<=20个

名称	类型	示例值	描述
result	ResultData		返回结果
└ msg String 查询成功提示信息 data_list EventVO [] 返回列表数据 └ real_name_buy_limit_type Number 1 实名制购买类型；1=一单一证，2=一票一证 └ real_name_buy_limit_boolean Boolean true 是否需要实名制购买；true=是，false=否 exchange_place_list ExchangePlace [] 当前场次取票点信息 └ address String 北京市朝阳区xxx大街xx号北京世纪剧院取票点详细地址 └ longitude String 116.413384 经度，高德地图坐标 └ latitude String 39.910925 纬度，高德地图坐标 └ place_type_list Number [] 1,2 取票点类型list，1=人工服务，2=自助取票机；可既是1又是2 work_time_list WorkTime [] 工作时间list；例：周一到周五早上10点到晚上21点；周六周日早上8点到晚上22点 └ work_end_time String 18:00 工作时间，结束时间格式：HH:mm；当work_date_type=1时非空 └ work_start_time String 10:00 工作时间，开始时间格式：HH:mm；当work_date_type=1时非空 └ work_date_sets Number [] 1,2,3,4,5 具体一周中周几工作；例 Set = 1,2,3,4,5 : 周一、周二、周三、周四、周五工作；当work_date_type=1时非空 └ work_date_desc String 演出前2小时自定义工作时间；当work_date_type=2时非空 └ work_date_type Number 2 工作时间类型；1=固定时间，2=自定义时间 └ delivery_type_list Number [] 2,3 取票方式list；2=身份证自助换票（换纸质票），3=取票码自助换票（换纸质票），4=二维码自助换票（换纸质票），6=二维码电子票（无纸质票），7=快递； ,11=证件电子票（无纸质票）一个场次可同时支持多种取票方式，但下单只能选择一种 └ event_end_time String 2019-10-31 22:00 场次演出结束时间，精确到分，格式：yyyy-MM-dd HH:mm └ event_start_time String 2019-10-31 20:00 场次演出开始时间，精确到分，格式：yyyy-MM-dd HH:mm └ event_sale_state Number 2 场次销售状态；2=销售中仅返回销售中的数据；倒计时项目会返回 1待销售取消的场次会返回 4已取消 └ event_name String 2019-10-31 星期四 20:00 麦座场次名称 └ project_id String 6134001011588 麦座项目id └ event_id String 717691815230 麦座场次id price_list PriceVO [] 场次下票档信息列表 └ margin_stock_num Number 239 剩余库存数量；仅项目座位购买类型为无座时返回 └ price_color String #FFFFF 票档颜色；项目座位购买类型为有座（自助选座）时非空；选座渲染时可使用 └ price_money_fen Number 18000 票档价格；单位：分 package_info_list PackageInfo [] 套票信息；票档类型priceType=2或3时非空；例：套票（1802），套票（1801+280*2） └ num Number 2 套票中包含的单票数量（无座自由组合套票购买时，一票一证的参数数量和此值保持一致） └ price_id String 73817367115320 单票票档id └ price_type Number 1 票档类型；1=单票，2=固定套票，3自由组合套票 └ price_sale_state Number 1 票档销售状态；1=可售，2=禁售 └ price_name String 180元票档名称 └ event_id String 717691815230 麦座场次id └ price_id String 82637162715320 票档id └ venue_basemap_svg_url String https://xxx.svg 场馆座位底图url；项目为选座项目时非空，渲染选座时使用 └ single_card_limit_num Number 2 单个证件累计限购数量；当前场次单个证件（一单一证或一票一证持票人）；0=不限购 └ venue_name String 北京世纪剧院场次所在场馆名称 └ venue_id String 1872771911531 场次所在场馆id；一个项目下多场次允许有多个场馆； └ promotion_id_list String [] 1323,1343 场次绑定的优惠id列表；票品和订单优惠 └ venue_basemap_version_id String 119005011731 场馆座位底图版本id；一个场馆可有多个底图版本；用于区分底图唯一性，不同项目不同场次可使用一个底图； └ venue_version_id String 119005011732 场馆版本id;场次可以使用同一个座位模板 └ count_down_state String 1 倒计时状态；0取消 1倒计时中 2倒计时结束 └ count_down_end_time Date 2023-01-01 11:30:00 倒计时结束时间 └ count_down_sms_reminder Boolean true 倒计时场次是否开启了短信提醒 └ code String 200 状态码 └ success Boolean true 是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzEventListRequest req = new AlibabaDamaiMzEventListRequest();
AlibabaDamaiMzEventListRequest.EventListParam obj1 = new AlibabaDamaiMzEventListRequest.EventListParam();
obj1.setProjectId("6134001011588");
obj1.setEventIdList("717691815230,2836818415130");
req.setParam(obj1);
AlibabaDamaiMzEventListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMzEventListRequest req = new AlibabaDamaiMzEventListRequest();
AlibabaDamaiMzEventListRequest.EventListParamDomain obj1 = new AlibabaDamaiMzEventListRequest.EventListParamDomain();
obj1.ProjectId = "6134001011588";
obj1.EventIdList = "717691815230,2836818415130";
req.Param_ = obj1;
AlibabaDamaiMzEventListResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMzEventListRequest;
$param = new EventListParam;
$param->project_id="6134001011588";
$param->event_id_list="717691815230,2836818415130";
$req->setParam(json_encode($param));
$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.event.list' \
-d 'partner_id=apidoc' \
-d 'sign=93499780BB9D7919315D714774153C32' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-11-01+04%3A23%3A59' \
-d 'v=2.0' \
-d 'param=null'

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

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

req.param=""
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.event.list");
add_param(pRequest,"param","数据结构JSON示例");
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.event.list', {
	'param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_mz_event_list_response>
    <result>
        <msg>查询成功</msg>
        <data_list>
            <event_v_o>
                <real_name_buy_limit_type>1</real_name_buy_limit_type>
                <real_name_buy_limit_boolean>true</real_name_buy_limit_boolean>
                <exchange_place_list>
                    <exchange_place>
                        <address>北京市朝阳区xxx大街xx号北京世纪剧院</address>
                        <longitude>116.413384</longitude>
                        <latitude>39.910925</latitude>
                        <place_type_list>
                            <number>1</number>
                            <number>2</number>
                        </place_type_list>
                        <work_time_list>
                            <work_time>
                                <work_end_time>18:00</work_end_time>
                                <work_start_time>10:00</work_start_time>
                                <work_date_sets>
                                    <number>1</number>
                                    <number>2</number>
                                    <number>3</number>
                                    <number>4</number>
                                    <number>5</number>
                                </work_date_sets>
                                <work_date_desc>演出前2小时</work_date_desc>
                                <work_date_type>2</work_date_type>
                            </work_time>
                        </work_time_list>
                    </exchange_place>
                </exchange_place_list>
                <delivery_type_list>
                    <number>2</number>
                    <number>3</number>
                </delivery_type_list>
                <event_end_time>2019-10-31 22:00</event_end_time>
                <event_start_time>2019-10-31 20:00</event_start_time>
                <event_sale_state>2</event_sale_state>
                <event_name>2019-10-31 星期四 20:00</event_name>
                <project_id>6134001011588</project_id>
                <event_id>717691815230</event_id>
                <price_list>
                    <price_v_o>
                        <margin_stock_num>239</margin_stock_num>
                        <price_color>#FFFFF</price_color>
                        <price_money_fen>18000</price_money_fen>
                        <package_info_list>
                            <package_info>
                                <num>2</num>
                                <price_id>73817367115320</price_id>
                            </package_info>
                        </package_info_list>
                        <price_type>1</price_type>
                        <price_sale_state>1</price_sale_state>
                        <price_name>180元</price_name>
                        <event_id>717691815230</event_id>
                        <price_id>82637162715320</price_id>
                    </price_v_o>
                </price_list>
                <venue_basemap_svg_url>https://xxx.svg</venue_basemap_svg_url>
                <single_card_limit_num>2</single_card_limit_num>
                <venue_name>北京世纪剧院</venue_name>
                <venue_id>1872771911531</venue_id>
                <promotion_id_list>
                    <string>1323</string>
                    <string>1343</string>
                </promotion_id_list>
                <venue_basemap_version_id>119005011731</venue_basemap_version_id>
                <venue_version_id>119005011732</venue_version_id>
                <count_down_state>1</count_down_state>
                <count_down_end_time>2023-01-01 11:30:00</count_down_end_time>
                <count_down_sms_reminder>true</count_down_sms_reminder>
            </event_v_o>
        </data_list>
        <code>200</code>
        <success>true</success>
    </result>
</alibaba_damai_mz_event_list_response>

{
    "alibaba_damai_mz_event_list_response":{
        "result":{
            "msg":"查询成功",
            "data_list":{
                "event_v_o":[
                    {
                        "real_name_buy_limit_type":1,
                        "real_name_buy_limit_boolean":true,
                        "exchange_place_list":{
                            "exchange_place":[
                                {
                                    "address":"北京市朝阳区xxx大街xx号北京世纪剧院",
                                    "longitude":"116.413384",
                                    "latitude":"39.910925",
                                    "place_type_list":{
                                        "number":[
                                            1,
                                            2
                                        ]
                                    },
                                    "work_time_list":{
                                        "work_time":[
                                            {
                                                "work_end_time":"18:00",
                                                "work_start_time":"10:00",
                                                "work_date_sets":{
                                                    "number":[
                                                        1,
                                                        2,
                                                        3,
                                                        4,
                                                        5
                                                    ]
                                                },
                                                "work_date_desc":"演出前2小时",
                                                "work_date_type":2
                                            }
                                        ]
                                    }
                                }
                            ]
                        },
                        "delivery_type_list":{
                            "number":[
                                2,
                                3
                            ]
                        },
                        "event_end_time":"2019-10-31 22:00",
                        "event_start_time":"2019-10-31 20:00",
                        "event_sale_state":2,
                        "event_name":"2019-10-31 星期四 20:00",
                        "project_id":"6134001011588",
                        "event_id":"717691815230",
                        "price_list":{
                            "price_v_o":[
                                {
                                    "margin_stock_num":239,
                                    "price_color":"#FFFFF",
                                    "price_money_fen":18000,
                                    "package_info_list":{
                                        "package_info":[
                                            {
                                                "num":2,
                                                "price_id":"73817367115320"
                                            }
                                        ]
                                    },
                                    "price_type":1,
                                    "price_sale_state":1,
                                    "price_name":"180元",
                                    "event_id":"717691815230",
                                    "price_id":"82637162715320"
                                }
                            ]
                        },
                        "venue_basemap_svg_url":"https:\/\/xxx.svg",
                        "single_card_limit_num":2,
                        "venue_name":"北京世纪剧院",
                        "venue_id":"1872771911531",
                        "promotion_id_list":{
                            "string":[
                                "1323",
                                "1343"
                            ]
                        },
                        "venue_basemap_version_id":"119005011731",
                        "venue_version_id":"119005011732",
                        "count_down_state":"1",
                        "count_down_end_time":"2023-01-01 11:30:00",
                        "count_down_sms_reminder":true
                    }
                ]
            },
            "code":"200",
            "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.event.list (场次列表API)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ