淘宝开放平台 - 文档中心

请求地址：

环境	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_root	ProjectParam	必须			项目根对象
project ProjectDto 必须项目数据 └ city_id Number 必须 10 城市id └ country_id Number 必须 20 国家id └ extend_info String 可选扩展信息扩展信息 └ first_category String 必须 10011 一级分类 └ has_seat Boolean 必须 true 是否有座位 └ id String 必须 123456 项目id └ name String 必须周杰伦成都演唱会项目名称 └ performer String 可选周杰伦表演人 └ post_url String 可选 http://google.com 项目海报url └ remark String 可选无备注 └ secondary_category String 必须 1001100 二级分类 └ third_category String 必须 100110011 三级分类 └ venue_id String 必须 20 场馆id └ need_contact_email Boolean 可选 true/false 是否需要联系人邮箱 └ phoenix_project Boolean 可选仅麦座v6使用，第三方传false 是否为凤凰项目，默认false └ approval_code String 可选 BJ123 批文code └ approval_url String 可选 test 批文号 └ project_types String [] 可选 212 项目类型 └ cancel_order_time Number 可选 900 三方商家消单时间，单位秒 venue VenueDto 必须场馆对象 └ address String 可选四川体育场地址 └ desc String 可选无描述 └ id String 必须 20 场馆id └ latitude String 可选 0 纬度 └ longitude String 可选 0 经度 └ name String 必须四川体育场场馆名称 └ venue_image String 可选无场馆图片，base64格式 └ message_id String 可选 project-message 消息id └ seller_id String 必须 qazqwer 商家id project_base_info ProjectBaseInfoDto 可选项目详情信息 └ vendor_id Number 可选 12 商家id └ project_id String 可选 12 项目id └ project_name String 可选德云社xxx 项目名称 └ standard_project_name String 可选德云社xxx 标准项目名称 └ recommend String 可选 test 推荐语 └ child_ticket_type Number 可选 1 儿童购票类型/儿童入场提示 └ child_ticket_desc String 可选 test 儿童购票描述 └ classify_label String 可选 test 主站类目标签 └ deposit_type Number 可选 1 寄存说明类型 └ deposit_desc String 可选 test 寄存说明有寄存处时填写 └ entry_time Number 可选 1 入场时间类型 └ entry_time_desc String 可选 test 入场时间描述 └ lowest_show_chapter String 可选 1 最低演出曲目数 └ lowest_show_time String 可选 1小时最低演出时长 └ main_actor String 可选 test 主要演员 └ posters String 可选 test 海报 └ restricted_item String 可选 test 禁止携带物品 └ show_time Number 可选 1 演出时长 └ show_time_desc String 可选 test 演出时长描述 └ seating_mode Number 可选 0 入座方式：0对号入座，1不对号入座，2对区不对号，3无座位，4多场次复合情况 └ important_note String 可选 test 重要说明 └ introduce String 可选 test 演出介绍/项目简介 └ shuttle_bus Number 可选 1 班车：1、有班车/0、无班车 └ camping Number 可选 1 露营 1、有露营/0、无露营 └ park String 可选 test 停车信息 └ lang Number 可选 0 语言 0普通话/1粤语/2英语/3其他 └ subtitle Number 可选 0 字幕 0中文字幕/1英文字幕/2中英文/3无字幕/4其他 └ age_children Number 可选 0 适龄儿童 0、满3岁/1、满5岁/2、满7岁/3、全年龄/4、其他 └ performance_type Number 可选 0 演出形式 0真人/1人偶/2放映/3皮影/4其他 └ guide Number 可选 1 导览 1有导览/0无导览 └ photo Number 可选 1 拍照 1允许拍照/0不允许拍照 └ t_sub_classify_code String 可选 12 主站二级类目code └ t_sub_classify_name String 可选 test 主站二级类目name └ t_third_classify_code String 可选 test 主站三级类目code └ t_third_classify_name String 可选 test 主站三级类目name

名称	类型	示例值	描述
result	YunResult	result	result
└ code Number 200 code └ success Boolean true success └ message String success message └ model String {} model

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiBtoyunSyncProjectRequest req = new AlibabaDamaiBtoyunSyncProjectRequest();
AlibabaDamaiBtoyunSyncProjectRequest.ProjectParam obj1 = new AlibabaDamaiBtoyunSyncProjectRequest.ProjectParam();
AlibabaDamaiBtoyunSyncProjectRequest.ProjectDto obj2 = new AlibabaDamaiBtoyunSyncProjectRequest.ProjectDto();
obj2.setCityId(10L);
obj2.setCountryId(20L);
obj2.setExtendInfo("扩展信息");
obj2.setFirstCategory("10011");
obj2.setHasSeat(true);
obj2.setId("123456");
obj2.setName("周杰伦成都演唱会");
obj2.setPerformer("周杰伦");
obj2.setPostUrl("http://google.com");
obj2.setRemark("无");
obj2.setSecondaryCategory("1001100");
obj2.setThirdCategory("100110011");
obj2.setVenueId("20");
obj2.setNeedContactEmail(true/false);
obj2.setPhoenixProject(仅麦座v6使用，第三方传false);
obj2.setApprovalCode("BJ123");
obj2.setApprovalUrl("test");
obj2.setProjectTypes("212");
obj2.setCancelOrderTime(900L);
obj1.setProject(obj2);
AlibabaDamaiBtoyunSyncProjectRequest.VenueDto obj3 = new AlibabaDamaiBtoyunSyncProjectRequest.VenueDto();
obj3.setAddress("四川体育场");
obj3.setDesc("无");
obj3.setId("20");
obj3.setLatitude("0");
obj3.setLongitude("0");
obj3.setName("四川体育场");
obj3.setVenueImage("无");
obj1.setVenue(obj3);
obj1.setMessageId("project-message");
obj1.setSellerId("qazqwer");
AlibabaDamaiBtoyunSyncProjectRequest.ProjectBaseInfoDto obj4 = new AlibabaDamaiBtoyunSyncProjectRequest.ProjectBaseInfoDto();
obj4.setVendorId(12L);
obj4.setProjectId("12");
obj4.setProjectName("德云社xxx");
obj4.setStandardProjectName("德云社xxx");
obj4.setRecommend("test");
obj4.setChildTicketType(1L);
obj4.setChildTicketDesc("test");
obj4.setClassifyLabel("test");
obj4.setDepositType(1L);
obj4.setDepositDesc("test");
obj4.setEntryTime(1L);
obj4.setEntryTimeDesc("test");
obj4.setLowestShowChapter("1");
obj4.setLowestShowTime("1小时");
obj4.setMainActor("test");
obj4.setPosters("test");
obj4.setRestrictedItem("test");
obj4.setShowTime(1L);
obj4.setShowTimeDesc("test");
obj4.setSeatingMode(0L);
obj4.setImportantNote("test");
obj4.setIntroduce("test");
obj4.setShuttleBus(1L);
obj4.setCamping(1L);
obj4.setPark("test");
obj4.setLang(0L);
obj4.setSubtitle(0L);
obj4.setAgeChildren(0L);
obj4.setPerformanceType(0L);
obj4.setGuide(1L);
obj4.setPhoto(1L);
obj4.setTSubClassifyCode("12");
obj4.setTSubClassifyName("test");
obj4.setTThirdClassifyCode("test");
obj4.setTThirdClassifyName("test");
obj1.setProjectBaseInfo(obj4);
req.setProjectRoot(obj1);
AlibabaDamaiBtoyunSyncProjectResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiBtoyunSyncProjectRequest req = new AlibabaDamaiBtoyunSyncProjectRequest();
AlibabaDamaiBtoyunSyncProjectRequest.ProjectParamDomain obj1 = new AlibabaDamaiBtoyunSyncProjectRequest.ProjectParamDomain();
AlibabaDamaiBtoyunSyncProjectRequest.ProjectDtoDomain obj2 = new AlibabaDamaiBtoyunSyncProjectRequest.ProjectDtoDomain();
obj2.CityId = 10L;
obj2.CountryId = 20L;
obj2.ExtendInfo = "扩展信息";
obj2.FirstCategory = "10011";
obj2.HasSeat = true;
obj2.Id = "123456";
obj2.Name = "周杰伦成都演唱会";
obj2.Performer = "周杰伦";
obj2.PostUrl = "http://google.com";
obj2.Remark = "无";
obj2.SecondaryCategory = "1001100";
obj2.ThirdCategory = "100110011";
obj2.VenueId = "20";
obj2.NeedContactEmail = true/false;
obj2.PhoenixProject = 仅麦座v6使用，第三方传false;
obj2.ApprovalCode = "BJ123";
obj2.ApprovalUrl = "test";
obj2.ProjectTypes = "212";
obj2.CancelOrderTime = 900L;
obj1.Project= obj2;
AlibabaDamaiBtoyunSyncProjectRequest.VenueDtoDomain obj3 = new AlibabaDamaiBtoyunSyncProjectRequest.VenueDtoDomain();
obj3.Address = "四川体育场";
obj3.Desc = "无";
obj3.Id = "20";
obj3.Latitude = "0";
obj3.Longitude = "0";
obj3.Name = "四川体育场";
obj3.VenueImage = "无";
obj1.Venue= obj3;
obj1.MessageId = "project-message";
obj1.SellerId = "qazqwer";
AlibabaDamaiBtoyunSyncProjectRequest.ProjectBaseInfoDtoDomain obj4 = new AlibabaDamaiBtoyunSyncProjectRequest.ProjectBaseInfoDtoDomain();
obj4.VendorId = 12L;
obj4.ProjectId = "12";
obj4.ProjectName = "德云社xxx";
obj4.StandardProjectName = "德云社xxx";
obj4.Recommend = "test";
obj4.ChildTicketType = 1L;
obj4.ChildTicketDesc = "test";
obj4.ClassifyLabel = "test";
obj4.DepositType = 1L;
obj4.DepositDesc = "test";
obj4.EntryTime = 1L;
obj4.EntryTimeDesc = "test";
obj4.LowestShowChapter = "1";
obj4.LowestShowTime = "1小时";
obj4.MainActor = "test";
obj4.Posters = "test";
obj4.RestrictedItem = "test";
obj4.ShowTime = 1L;
obj4.ShowTimeDesc = "test";
obj4.SeatingMode = 0L;
obj4.ImportantNote = "test";
obj4.Introduce = "test";
obj4.ShuttleBus = 1L;
obj4.Camping = 1L;
obj4.Park = "test";
obj4.Lang = 0L;
obj4.Subtitle = 0L;
obj4.AgeChildren = 0L;
obj4.PerformanceType = 0L;
obj4.Guide = 1L;
obj4.Photo = 1L;
obj4.TSubClassifyCode = "12";
obj4.TSubClassifyName = "test";
obj4.TThirdClassifyCode = "test";
obj4.TThirdClassifyName = "test";
obj1.ProjectBaseInfo= obj4;
req.ProjectRoot_ = obj1;
AlibabaDamaiBtoyunSyncProjectResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiBtoyunSyncProjectRequest;
$project_root = new ProjectParam;
$project = new ProjectDto;
$project->city_id="10";
$project->country_id="20";
$project->extend_info="扩展信息";
$project->first_category="10011";
$project->has_seat="true";
$project->id="123456";
$project->name="周杰伦成都演唱会";
$project->performer="周杰伦";
$project->post_url="http://google.com";
$project->remark="无";
$project->secondary_category="1001100";
$project->third_category="100110011";
$project->venue_id="20";
$project->need_contact_email="true/false";
$project->phoenix_project="仅麦座v6使用，第三方传false";
$project->approval_code="BJ123";
$project->approval_url="test";
$project->project_types="212";
$project->cancel_order_time="900";
$project_root->project = $project;
$venue = new VenueDto;
$venue->address="四川体育场";
$venue->desc="无";
$venue->id="20";
$venue->latitude="0";
$venue->longitude="0";
$venue->name="四川体育场";
$venue->venue_image="无";
$project_root->venue = $venue;
$project_root->message_id="project-message";
$project_root->seller_id="qazqwer";
$project_base_info = new ProjectBaseInfoDto;
$project_base_info->vendor_id="12";
$project_base_info->project_id="12";
$project_base_info->project_name="德云社xxx";
$project_base_info->standard_project_name="德云社xxx";
$project_base_info->recommend="test";
$project_base_info->child_ticket_type="1";
$project_base_info->child_ticket_desc="test";
$project_base_info->classify_label="test";
$project_base_info->deposit_type="1";
$project_base_info->deposit_desc="test";
$project_base_info->entry_time="1";
$project_base_info->entry_time_desc="test";
$project_base_info->lowest_show_chapter="1";
$project_base_info->lowest_show_time="1小时";
$project_base_info->main_actor="test";
$project_base_info->posters="test";
$project_base_info->restricted_item="test";
$project_base_info->show_time="1";
$project_base_info->show_time_desc="test";
$project_base_info->seating_mode="0";
$project_base_info->important_note="test";
$project_base_info->introduce="test";
$project_base_info->shuttle_bus="1";
$project_base_info->camping="1";
$project_base_info->park="test";
$project_base_info->lang="0";
$project_base_info->subtitle="0";
$project_base_info->age_children="0";
$project_base_info->performance_type="0";
$project_base_info->guide="1";
$project_base_info->photo="1";
$project_base_info->t_sub_classify_code="12";
$project_base_info->t_sub_classify_name="test";
$project_base_info->t_third_classify_code="test";
$project_base_info->t_third_classify_name="test";
$project_root->project_base_info = $project_base_info;
$req->setProjectRoot(json_encode($project_root));
$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.btoyun.sync.project' \
-d 'partner_id=apidoc' \
-d 'sign=330A81341FFB9E0DC96C4B64792E76DE' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-27+22%3A09%3A24' \
-d 'v=2.0' \
-d 'project_root=null'

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

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

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

XML示例
JSON示例

<alibaba_damai_btoyun_sync_project_response>
    <result>
        <code>200</code>
        <success>true</success>
        <message>success</message>
        <model>{}</model>
    </result>
</alibaba_damai_btoyun_sync_project_response>

{
    "alibaba_damai_btoyun_sync_project_response":{
        "result":{
            "code":200,
            "success":true,
            "message":"success",
            "model":"{}"
        }
    }
}

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.btoyun.sync.project (项目数据同步)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ