淘宝开放平台 - 文档中心

请求地址：

环境	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	String	必须	1273693615230	最大长度：20	麦座项目id

名称	类型	示例值	描述
result	ResultData		返回结果
└ msg String 成功提示 └ code String 200 状态码 data ProjectDetailVO 返回数据 project_watching_notice Projectwatchingnotice 观演须知；可空 └ prohibit_goods_tips String 禁止携带专业录像设备、饮料禁止携带的物品说明； prohibitGoodsTips:"禁止携带专业录像设备、饮料" └ deposit_tips String 无寄存处寄存说明； depositTips，例::"无寄存处" └ children_entry_tips String 儿童一律凭票入场儿童入场提示； childrenEntryTips，例::"儿童一律凭票入场" └ entry_time_tips String 提前30分钟入场时间； entryTimeTips，例::"提前xx分钟" └ show_length_tips String 最少90分钟演出时长；showLengthTips，例:"最少xx分钟" └ project_introduce String 《乌龙山伯爵》因一张支票引出了许多笑料迭出的偶发事件，大起大落的剧情让观众看的津津有味。剧中谢蟹与恶霸科长的银行PK一幕中，破产科长又是在衣架上上吊、又是吞枪自杀的表演十分滑稽。正当观众被逗得大笑时，科长却将手枪对准了谢蟹，突然的逆转让台下观众屏息凝神，生怕错过一个画面。项目简介；格式：富文本；可空 └ project_img_url String http://xxx.jpg 项目海报图片地址；可空 └ second_class_id String 19737107001003 二级项目分类id └ first_class_id String 19737107001 一级项目分类id └ project_sale_state Number 2 项目销售状态；1=待销售，2=销售中，3=销售结束 └ project_seat_type Number 1 项目座位类型；1=有座自助选座，2=无座 └ project_name String 开心麻花经典爆笑舞台剧《乌龙山伯爵》项目名称 └ project_id String 1273693615230 麦座项目id └ second_class_name String 话剧二级项目分类名称 └ first_class_name String 话剧歌剧一级项目分类名称 └ project_round String 1 项目轮次 sponsor_info_list SponsorInfo [] 项目主办信息；可为空或多个； └ sponsor_name String 主办方名称xx 主办方名称 └ sponsor_id Number 3013891321 主办方id └ count_down_state String 1 倒计时项目状态；0取消 1倒计时中 2倒计时结束 └ count_down_end_time Date 1567868000 倒计时结束时间 └ count_down_sms_reminder Boolean true 倒计时场次是否开启了短信提醒 └ success Boolean true 是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzProjectDetailRequest req = new AlibabaDamaiMzProjectDetailRequest();
req.setProjectId("1273693615230");
AlibabaDamaiMzProjectDetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiMzProjectDetailRequest req = new AlibabaDamaiMzProjectDetailRequest();
req.ProjectId = "1273693615230";
AlibabaDamaiMzProjectDetailResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiMzProjectDetailRequest;
$req->setProjectId("1273693615230");
$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.project.detail' \
-d 'partner_id=apidoc' \
-d 'sign=10C5F4A67E818198C22CD3BDB69AE172' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+15%3A35%3A29' \
-d 'v=2.0' \
-d 'project_id=1273693615230'

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

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

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

XML示例
JSON示例

<alibaba_damai_mz_project_detail_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <project_watching_notice>
                <prohibit_goods_tips>禁止携带专业录像设备、饮料</prohibit_goods_tips>
                <deposit_tips>无寄存处</deposit_tips>
                <children_entry_tips>儿童一律凭票入场</children_entry_tips>
                <entry_time_tips>提前30分钟</entry_time_tips>
                <show_length_tips>最少90分钟</show_length_tips>
            </project_watching_notice>
            <project_introduce>《乌龙山伯爵》因一张支票引出了许多笑料迭出的偶发事件，大起大落的剧情让观众看的津津有味。剧中谢蟹与恶霸科长的银行PK一幕中，破产科长又是在衣架上上吊、又是吞枪自杀的表演十分滑稽。正当观众被逗得大笑时，科长却将手枪对准了谢蟹，突然的逆转让台下观众屏息凝神，生怕错过一个画面。</project_introduce>
            <project_img_url>http://xxx.jpg</project_img_url>
            <second_class_id>19737107001003</second_class_id>
            <first_class_id>19737107001</first_class_id>
            <project_sale_state>2</project_sale_state>
            <project_seat_type>1</project_seat_type>
            <project_name>开心麻花经典爆笑舞台剧《乌龙山伯爵》</project_name>
            <project_id>1273693615230</project_id>
            <second_class_name>话剧</second_class_name>
            <first_class_name>话剧歌剧</first_class_name>
            <project_round>1</project_round>
            <sponsor_info_list>
                <sponsor_info>
                    <sponsor_name>主办方名称xx</sponsor_name>
                    <sponsor_id>3013891321</sponsor_id>
                </sponsor_info>
            </sponsor_info_list>
            <count_down_state>1</count_down_state>
            <count_down_end_time>1567868000</count_down_end_time>
            <count_down_sms_reminder>true</count_down_sms_reminder>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_project_detail_response>

{
    "alibaba_damai_mz_project_detail_response":{
        "result":{
            "msg":"成功",
            "code":"200",
            "data":{
                "project_watching_notice":{
                    "prohibit_goods_tips":"禁止携带专业录像设备、饮料",
                    "deposit_tips":"无寄存处",
                    "children_entry_tips":"儿童一律凭票入场",
                    "entry_time_tips":"提前30分钟",
                    "show_length_tips":"最少90分钟"
                },
                "project_introduce":"《乌龙山伯爵》因一张支票引出了许多笑料迭出的偶发事件，大起大落的剧情让观众看的津津有味。剧中谢蟹与恶霸科长的银行PK一幕中，破产科长又是在衣架上上吊、又是吞枪自杀的表演十分滑稽。正当观众被逗得大笑时，科长却将手枪对准了谢蟹，突然的逆转让台下观众屏息凝神，生怕错过一个画面。",
                "project_img_url":"http:\/\/xxx.jpg",
                "second_class_id":"19737107001003",
                "first_class_id":"19737107001",
                "project_sale_state":2,
                "project_seat_type":1,
                "project_name":"开心麻花经典爆笑舞台剧《乌龙山伯爵》",
                "project_id":"1273693615230",
                "second_class_name":"话剧",
                "first_class_name":"话剧歌剧",
                "project_round":"1",
                "sponsor_info_list":{
                    "sponsor_info":[
                        {
                            "sponsor_name":"主办方名称xx",
                            "sponsor_id":3013891321
                        }
                    ]
                },
                "count_down_state":"1",
                "count_down_end_time":"1567868000",
                "count_down_sms_reminder":true
            },
            "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	分销渠道未授权	分销渠道未授权

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

开放平台

麦座API

alibaba.damai.mz.project.detail (项目详情API)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ