淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
mz_order_id	String	必须	77490100015203		麦座订单id；非空

名称	类型	示例值	描述
result	ResultData		api返回结果
└ msg String 成功提示 └ code String 200 状态码 data_list EticketVO [] 票凭证（电子票）列表出参 └ qr_original_code String 126adbsafhafb1414ndh 二维码原始值；可根据此值生成静态二维码；deliveryType=4或6时非空 └ exchange_code String 32575741 取票码；数字串或数字+字母组合串；一个订单只有一个取票码；deliveryType=3时非空 └ delivery_type Number 3 取票类型；2=身份证自助换票（换纸质票），3=取票码自助换票（换纸质票），4=二维码自助换票（换纸质票），6=二维码电子票（无纸质票） └ seat_name String 1号座位号名称；有座时非空，无座时为空 └ row_name String 1排排名称；有座时非空，无座时为空 └ stand_name String 1层看台名称；有座时非空，无座时为空 └ floor_name String 1楼楼层名称；有座时非空，无座时为空 └ seat_id String 1234 麦座座位id；有座时非空 └ price_money_fen Number 100 单票票档原价；单位：分 └ price_name String 普通票票档名称 └ price_id String 898001015203 麦座单票票档id └ venue_name String 测试场馆场馆名称 └ event_start_time String 2022-08-01 01:00 场次演出开始时间；精确到分，格式：yyyy-MM-dd HH:mm └ event_name String 测试场次麦座场次名称； └ event_id String 717001015203 场次id └ project_name String 测试项目项目名称 └ project_id String 590001015203 项目id └ has_seat Boolean false 是否有座；true=有座，false=无座 └ ticket_state Number 1 票状态；1=未使用，2=退票中，3=已退票，4=已验票，6=已换票 └ mz_order_id String 77490100015203 麦座订单号 └ ticket_code_no String 111452207 票单id └ success Boolean true api请求是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzBTicketListRequest req = new AlibabaDamaiMzBTicketListRequest();
req.setMzOrderId("77490100015203");
AlibabaDamaiMzBTicketListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMzBTicketListRequest req = new AlibabaDamaiMzBTicketListRequest();
req.MzOrderId = "77490100015203";
AlibabaDamaiMzBTicketListResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMzBTicketListRequest;
$req->setMzOrderId("77490100015203");
$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.b.ticket.list' \
-d 'partner_id=apidoc' \
-d 'sign=CDEC488C6BB734F0301264E52103BC67' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+14%3A51%3A49' \
-d 'v=2.0' \
-d 'mz_order_id=77490100015203'

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

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

req.mz_order_id="77490100015203"
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.b.ticket.list");
add_param(pRequest,"mz_order_id","77490100015203");
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.b.ticket.list', {
	'mz_order_id':'77490100015203'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_mz_b_ticket_list_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data_list>
            <eticket_v_o>
                <qr_original_code>126adbsafhafb1414ndh</qr_original_code>
                <exchange_code>32575741</exchange_code>
                <delivery_type>3</delivery_type>
                <seat_name>1号</seat_name>
                <row_name>1排</row_name>
                <stand_name>1层</stand_name>
                <floor_name>1楼</floor_name>
                <seat_id>1234</seat_id>
                <price_money_fen>100</price_money_fen>
                <price_name>普通票</price_name>
                <price_id>898001015203</price_id>
                <venue_name>测试场馆</venue_name>
                <event_start_time>2022-08-01 01:00</event_start_time>
                <event_name>测试场次</event_name>
                <event_id>717001015203</event_id>
                <project_name>测试项目</project_name>
                <project_id>590001015203</project_id>
                <has_seat>false</has_seat>
                <ticket_state>1</ticket_state>
                <mz_order_id>77490100015203</mz_order_id>
                <ticket_code_no>111452207</ticket_code_no>
            </eticket_v_o>
        </data_list>
        <success>true</success>
    </result>
</alibaba_damai_mz_b_ticket_list_response>

{
    "alibaba_damai_mz_b_ticket_list_response":{
        "result":{
            "msg":"成功",
            "code":"200",
            "data_list":{
                "eticket_v_o":[
                    {
                        "qr_original_code":"126adbsafhafb1414ndh",
                        "exchange_code":"32575741",
                        "delivery_type":3,
                        "seat_name":"1号",
                        "row_name":"1排",
                        "stand_name":"1层",
                        "floor_name":"1楼",
                        "seat_id":"1234",
                        "price_money_fen":100,
                        "price_name":"普通票",
                        "price_id":"898001015203",
                        "venue_name":"测试场馆",
                        "event_start_time":"2022-08-01 01:00",
                        "event_name":"测试场次",
                        "event_id":"717001015203",
                        "project_name":"测试项目",
                        "project_id":"590001015203",
                        "has_seat":false,
                        "ticket_state":1,
                        "mz_order_id":"77490100015203",
                        "ticket_code_no":"111452207"
                    }
                ]
            },
            "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请求失败	通用业务异常
40100006	请求必须的参数麦座会员id不能为空	请求必须的参数麦座会员id不能为空
15010014	请求参数不能为空	请求参数不能为空
15010017	票数据不存在	票数据不存在

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

开放平台

麦座API

alibaba.damai.mz.b.ticket.list (门店票凭证列表API)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ