淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
project_id	Number	必须	1111111		项目ID，前提已授权

名称	类型	示例值	描述
result	Result		接口返回model
└ success Boolean false 是否成功 └ error_code String 0 错误码 model OpenProjectDetailDto 134523^4351232 model └ children_notice String 儿童一律凭票入场儿童购票说明 └ self_get_ticket_notice String 需要您在指定的取票地点取票，请在确认订单的时候仔细确认取票地址（具体以下单后票夹信息为准）自助取票 └ show_start_time Date 1558604732000 演出开售时间 └ limit_notice String 选座购买每单限6张，立即购买每单限20张限购说明 └ deposit_info String 无寄存处，请自行保管携带物品寄存说明 └ show_detail String <h3>内容</h3></p> 演出详情 └ real_name_notice String 无需实名制购票实名制购票 └ prohibited_items String 由于安保和版权的原因，大多数演出、展览及比赛场所禁止携带食品、饮料、专业摄录设备、打火机等物品，请您注意现场工作人员和广播的提示，予以配合禁止携带物品说明 └ show_pic String https://a.jpg 演出海报图 └ policy_of_return String 票品不支持退换。如无法正常观看，还请自行处理，给您带来不便敬请谅解退换政策 └ entrance_notice String 入场说明入场说明 └ project_name String 项目名称项目名称 └ classify_code Number 127388004 项目分类编码 └ sub_classify_name String 展览/活动二级项目分类名称 └ choice_seat_notice String 暂不支持选座是否支持选座 └ eticket_notice String 通过票夹中的二维码或身份证，可以直接验票入场（具体以下单后票夹信息为准）电子票入场提示 └ project_id Number 1111111 项目id └ show_end_time Date 1567353540000 演出销售结束时间 └ classify_name String 展览/活动项目分类名称 └ sub_classify_code Number 127420014 二级项目分类编码 └ artists String [{"artistId":1,"artistName":"张三","picUrl":"https://intercms.damai.cn/artist/pic/11-main.jpg"}] 艺人JSON └ ip_card String {"ipId":1,"ipPic":"https://intercms.damai.cn/ip/pic/1-main.jpg","title":"品牌名称"} 品牌JSON └ show_time String 2020.08.01-09.01 演出时间 └ delivery_types String [2,4] 取票类型1-无纸化,2-快递票,3-自助换票,4-门店自取。1、3属于电子票换票方式,2、4属于纸质票取票方式 └ post_city String 110100 发货城市，国标http://www.mca.gov.cn/article/sj/xzqh/2019/2019/201912251506.html └ pickup_address_list String [{"address":"北京市东城区东中街32号楼7层（东环广场街心花园对面）1","businessHours":"星期一至星期日9:00-18:00","id":1,"lat":"39.93721 ","lon":"116.436787111111","name":"大麦网北京总部","tel":"10103721 / 4006103721"}] 上门自取地址 └ perform_time_detail_list String [{ "performId": 170083666, "performTimeDetail": "说明信息" }] 演出时间说明 └ purchase_limitation_once Number 6 项目单次限购数量 └ damai_item_id Number 622291099991 大麦商品id refund_project_rule_info RefundProjectRuleInfoDTO 退款规则 └ id Number 12345 唯一id └ gmt_create Date 1701245362000 创建时间 └ gmt_modified Date 1701245362000 更新时间 └ project_id Number 213344556 项目id └ refund_type Number 1 退票类型1-不可退，2-无忧退，3-条件退，4-未核销退，5-新条件退，6-随时退 └ c_end_entrance Number 1 C端退票入口，枚举值：开启入口 1（默认），不开启入口 0 └ paper_ticket_recycle_rule Number 1 纸质票回收规则,0-不回收,1-废票照片回收（默认1）,2-快递回收 └ refund_express_fee_rule Number 1 退快递费规则,0-不退回,1-退回,2-根据履约状态判断（默认）2 └ has_refund_platform_service Number 1 退票平台服务费是否收取,0-不收取，1-收取 └ refund_platform_service_fee BigDecimal 11.23 退票平台服务费，自定义服务费保留到小数点后2位 └ refund_procedure_fee_rule Number 1 退票手续费规则 1指定时间规则，2据场次演出开始时间倒计时规则 refund_detail RefundDateInfoRule [] 退票手续费具体明细，1，2对应的明细不同 └ start_time Date 1701245362000 开始时间 └ end_time Date 1701245362000 结束时间 └ start_day Number 1 距离场次开始时间-天 └ start_hour Number 12 距离场次开始时间-时 └ start_minutes Number 36 距离场次开始时间-分 └ end_day Number 2 距离场次结束时间-天 └ end_hour Number 2 距离场次结束时间-时 └ end_minutes Number 12 距离场次结束时间-分 └ refund_rule Number 1 退票类型,1-手续费,2-免费退票,3-不支持退,4-停止退票 └ refund_rule_free BigDecimal 3.26 退票手续费,支持小数点后2位，如1.11% └ error_msg String 成功错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMaitixProjectDistributionDetailQueryRequest req = new AlibabaDamaiMaitixProjectDistributionDetailQueryRequest();
req.setProjectId(1111111L);
AlibabaDamaiMaitixProjectDistributionDetailQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMaitixProjectDistributionDetailQueryRequest req = new AlibabaDamaiMaitixProjectDistributionDetailQueryRequest();
req.ProjectId = 1111111L;
AlibabaDamaiMaitixProjectDistributionDetailQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMaitixProjectDistributionDetailQueryRequest;
$req->setProjectId("1111111");
$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.maitix.project.distribution.detail.query' \
-d 'partner_id=apidoc' \
-d 'sign=D4E3C9FF6DE357A630C643E3A38548BB' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-27+14%3A17%3A27' \
-d 'v=2.0' \
-d 'project_id=1111111'

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

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

req.project_id=1111111
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.maitix.project.distribution.detail.query");
add_param(pRequest,"project_id","1111111");
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.maitix.project.distribution.detail.query', {
	'project_id':'1111111'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_damai_maitix_project_distribution_detail_query_response>
    <result>
        <success>false</success>
        <error_code>0</error_code>
        <model>
            <children_notice>儿童一律凭票入场</children_notice>
            <self_get_ticket_notice>需要您在指定的取票地点取票，请在确认订单的时候仔细确认取票地址（具体以下单后票夹信息为准）</self_get_ticket_notice>
            <show_start_time>1558604732000</show_start_time>
            <limit_notice>选座购买每单限6张，立即购买每单限20张</limit_notice>
            <deposit_info>无寄存处，请自行保管携带物品</deposit_info>
            <show_detail>&lt;h3&gt;内容&lt;/h3&gt;&lt;/p&gt;</show_detail>
            <real_name_notice>无需实名制购票</real_name_notice>
            <prohibited_items>由于安保和版权的原因，大多数演出、展览及比赛场所禁止携带食品、饮料、专业摄录设备、打火机等物品，请您注意现场工作人员和广播的提示，予以配合</prohibited_items>
            <show_pic>https://a.jpg</show_pic>
            <policy_of_return>票品不支持退换。如无法正常观看，还请自行处理，给您带来不便敬请谅解</policy_of_return>
            <entrance_notice>入场说明</entrance_notice>
            <project_name>项目名称</project_name>
            <classify_code>127388004</classify_code>
            <sub_classify_name>展览/活动</sub_classify_name>
            <choice_seat_notice>暂不支持选座</choice_seat_notice>
            <eticket_notice>通过票夹中的二维码或身份证，可以直接验票入场（具体以下单后票夹信息为准）</eticket_notice>
            <project_id>1111111</project_id>
            <show_end_time>1567353540000</show_end_time>
            <classify_name>展览/活动</classify_name>
            <sub_classify_code>127420014</sub_classify_code>
            <artists>[{&quot;artistId&quot;:1,&quot;artistName&quot;:&quot;张三&quot;,&quot;picUrl&quot;:&quot;https://intercms.damai.cn/artist/pic/11-main.jpg&quot;}]</artists>
            <ip_card>{&quot;ipId&quot;:1,&quot;ipPic&quot;:&quot;https://intercms.damai.cn/ip/pic/1-main.jpg&quot;,&quot;title&quot;:&quot;品牌名称&quot;}</ip_card>
            <show_time>2020.08.01-09.01</show_time>
            <delivery_types>[2,4]</delivery_types>
            <post_city>110100</post_city>
            <pickup_address_list>[{&quot;address&quot;:&quot;北京市东城区东中街32号楼7层（东环广场街心花园对面）1&quot;,&quot;businessHours&quot;:&quot;星期一至星期日9:00-18:00&quot;,&quot;id&quot;:1,&quot;lat&quot;:&quot;39.93721 &quot;,&quot;lon&quot;:&quot;116.436787111111&quot;,&quot;name&quot;:&quot;大麦网北京总部&quot;,&quot;tel&quot;:&quot;10103721 / 4006103721&quot;}]</pickup_address_list>
            <perform_time_detail_list>[{ 	&quot;performId&quot;: 170083666, 	&quot;performTimeDetail&quot;: &quot;说明信息&quot; }]</perform_time_detail_list>
            <purchase_limitation_once>6</purchase_limitation_once>
            <damai_item_id>622291099991</damai_item_id>
            <refund_project_rule_info>
                <id>12345</id>
                <gmt_create>1701245362000</gmt_create>
                <gmt_modified>1701245362000</gmt_modified>
                <project_id>213344556</project_id>
                <refund_type>1</refund_type>
                <c_end_entrance>1</c_end_entrance>
                <paper_ticket_recycle_rule>1</paper_ticket_recycle_rule>
                <refund_express_fee_rule>1</refund_express_fee_rule>
                <has_refund_platform_service>1</has_refund_platform_service>
                <refund_platform_service_fee>11.23</refund_platform_service_fee>
                <refund_procedure_fee_rule>1</refund_procedure_fee_rule>
                <refund_detail>
                    <refund_date_info_rule>
                        <start_time>1701245362000</start_time>
                        <end_time>1701245362000</end_time>
                        <start_day>1</start_day>
                        <start_hour>12</start_hour>
                        <start_minutes>36</start_minutes>
                        <end_day>2</end_day>
                        <end_hour>2</end_hour>
                        <end_minutes>12</end_minutes>
                        <refund_rule>1</refund_rule>
                        <refund_rule_free>3.26</refund_rule_free>
                    </refund_date_info_rule>
                </refund_detail>
            </refund_project_rule_info>
        </model>
        <error_msg>成功</error_msg>
    </result>
</alibaba_damai_maitix_project_distribution_detail_query_response>

{
    "alibaba_damai_maitix_project_distribution_detail_query_response":{
        "result":{
            "success":false,
            "error_code":"0",
            "model":{
                "children_notice":"儿童一律凭票入场",
                "self_get_ticket_notice":"需要您在指定的取票地点取票，请在确认订单的时候仔细确认取票地址（具体以下单后票夹信息为准）",
                "show_start_time":"1558604732000",
                "limit_notice":"选座购买每单限6张，立即购买每单限20张",
                "deposit_info":"无寄存处，请自行保管携带物品",
                "show_detail":"<h3>内容<\/h3><\/p>",
                "real_name_notice":"无需实名制购票",
                "prohibited_items":"由于安保和版权的原因，大多数演出、展览及比赛场所禁止携带食品、饮料、专业摄录设备、打火机等物品，请您注意现场工作人员和广播的提示，予以配合",
                "show_pic":"https:\/\/a.jpg",
                "policy_of_return":"票品不支持退换。如无法正常观看，还请自行处理，给您带来不便敬请谅解",
                "entrance_notice":"入场说明",
                "project_name":"项目名称",
                "classify_code":127388004,
                "sub_classify_name":"展览\/活动",
                "choice_seat_notice":"暂不支持选座",
                "eticket_notice":"通过票夹中的二维码或身份证，可以直接验票入场（具体以下单后票夹信息为准）",
                "project_id":1111111,
                "show_end_time":"1567353540000",
                "classify_name":"展览\/活动",
                "sub_classify_code":127420014,
                "artists":"[{\"artistId\":1,\"artistName\":\"张三\",\"picUrl\":\"https:\/\/intercms.damai.cn\/artist\/pic\/11-main.jpg\"}]",
                "ip_card":"{\"ipId\":1,\"ipPic\":\"https:\/\/intercms.damai.cn\/ip\/pic\/1-main.jpg\",\"title\":\"品牌名称\"}",
                "show_time":"2020.08.01-09.01",
                "delivery_types":"[2,4]",
                "post_city":"110100",
                "pickup_address_list":"[{\"address\":\"北京市东城区东中街32号楼7层（东环广场街心花园对面）1\",\"businessHours\":\"星期一至星期日9:00-18:00\",\"id\":1,\"lat\":\"39.93721 \",\"lon\":\"116.436787111111\",\"name\":\"大麦网北京总部\",\"tel\":\"10103721 \/ 4006103721\"}]",
                "perform_time_detail_list":"[{ \t\"performId\": 170083666, \t\"performTimeDetail\": \"说明信息\" }]",
                "purchase_limitation_once":6,
                "damai_item_id":622291099991,
                "refund_project_rule_info":{
                    "id":12345,
                    "gmt_create":"1701245362000",
                    "gmt_modified":"1701245362000",
                    "project_id":213344556,
                    "refund_type":1,
                    "c_end_entrance":1,
                    "paper_ticket_recycle_rule":1,
                    "refund_express_fee_rule":1,
                    "has_refund_platform_service":1,
                    "refund_platform_service_fee":"11.23",
                    "refund_procedure_fee_rule":1,
                    "refund_detail":{
                        "refund_date_info_rule":[
                            {
                                "start_time":"1701245362000",
                                "end_time":"1701245362000",
                                "start_day":1,
                                "start_hour":12,
                                "start_minutes":36,
                                "end_day":2,
                                "end_hour":2,
                                "end_minutes":12,
                                "refund_rule":1,
                                "refund_rule_free":"3.26"
                            }
                        ]
                    }
                }
            },
            "error_msg":"成功"
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案

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

开放平台

大麦票务云分销API

alibaba.damai.maitix.project.distribution.detail.query (大麦分销项目内容详情查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ