淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
performance_param	PerformanceParamDto	必须			场次参数根
combine_prices ItemPackageDto [] 可选套票 └ id String 可选 111111 套票id └ item_detail_id String 可选 111111 明细id └ item_number Number 可选 2 明细数量 └ name String 可选无名称，可省略 performances PerformanceDto [] 必须场次集合 └ end_time Date 可选 2017-10-31 10:10:00 结束时间 └ extend_info String 可选无扩展信息 └ id String 必须 111111 场次id └ name String 必须周杰伦演唱会场次名称 └ project_id String 必须 111111 项目id └ sale_end_time Date 可选 2017-10-15 10:10:00 销售结束时间 └ sale_start_time Date 可选 2017-10-01 10:10:00 销售开始时间 └ seat_by_number Boolean 必须 true 是否对号入座，true=是，false=否 └ show_time Date 必须 2017-10-31 08:10:00 演出时间 └ status Number 必须 20 状态,状态：20=待销售，30=销售中，40=演出取消，50=演出结束 venue_images VenueImageDto [] 可选场馆底图列表 └ venue_image String 可选 11111 底图内容 └ image_type Number 可选 11 底图类型 prices ItemDto [] 必须价格集合 └ color String 必须 #FFFFFF 颜色 └ extend_info String 可选无扩展信息 └ id String 必须 111111 价格id └ name String 必须 100元价格名称 └ performance_id String 必须 222222 场次id └ project_id String 必须 333333 项目id └ remark String 可选无备注 └ status Number 必须 1 票品状态：1 创建中，2 已创建，3 已上架 4 已下架 5 已停售 └ stock_number Number 可选 2 库存数，无座项目必填 └ type Number 必须 1 票品类型，1=单票，2=套票 └ unit_price_of_fen Number 必须 10000 单价，分 └ package_type Number 可选 1 1固定套票2自由套票 └ project_id String 必须 333333 项目id sale_rules SaleRuleDto [] 可选销售规则 └ eticket_type String [] 必须 1 电子票类型：1=身份证电子票；2=二维码电子票；3=串码 └ performance_id String 必须 222222 场次id └ ticket_type String [] 必须 1 出票类型:1=纸质票；2=电子票 └ qr_eticket_type Number 可选 0 二维码电子票类型（仅当电子票类型有二维码电子票时传此参数）0静态 1动态 └ take_ticket_type String [] 可选 1 取票方式 1，无纸化；2，快递票；3，自助换票；4，门店自取 └ enter_type String [] 可选 2 入场方式 1=纸质票入场 2=电子票入场 └ enable_ticket_cert Boolean 可选 true 是否开启购票实名制 true=实名 false=不实名 └ enable_real_name_enter Boolean 可选 true 是否实名制入场说明:如果设置了实名制入场，则必须开启购票实名制，如果开启购票实名制,可以不设置实名制入场 └ enable_eticket_enter Boolean 可选 true 是否电子票入场(废弃)入场方式以enterType为准 └ from_phoenix Boolean 可选 true 标识字段 true标识来自凤凰的销售规则,和票务云销售规则对齐 ticket_cert_rule TicketCertRuleDto 可选购票实名制规则 └ rule_type Number 可选 1 规则类型：1=一单一证，2=一票一证 └ cert_types String [] 可选 1 证件类型，1=身份证，2=护照，3=港澳通行证，4=台胞证，5=军人证 └ message_id String 必须 performance-message 消息id └ seller_id String 必须 qazqwer 商家id

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

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiBtoyunSyncPerformanceRequest req = new AlibabaDamaiBtoyunSyncPerformanceRequest();
AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceParamDto obj1 = new AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceParamDto();
List<AlibabaDamaiBtoyunSyncPerformanceRequest.ItemPackageDto> list3 = new ArrayList<AlibabaDamaiBtoyunSyncPerformanceRequest.ItemPackageDto>();
AlibabaDamaiBtoyunSyncPerformanceRequest.ItemPackageDto obj4 = new AlibabaDamaiBtoyunSyncPerformanceRequest.ItemPackageDto();
list3.add(obj4);
obj4.setId("111111");
obj4.setItemDetailId("111111");
obj4.setItemNumber(2L);
obj4.setName("无");
obj1.setCombinePrices(list3);
List<AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceDto> list6 = new ArrayList<AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceDto>();
AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceDto obj7 = new AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceDto();
list6.add(obj7);
obj7.setEndTime(StringUtils.parseDateTime("2017-10-31 10:10:00"));
obj7.setExtendInfo("无");
obj7.setId("111111");
obj7.setName("周杰伦演唱会");
obj7.setProjectId("111111");
obj7.setSaleEndTime(StringUtils.parseDateTime("2017-10-15 10:10:00"));
obj7.setSaleStartTime(StringUtils.parseDateTime("2017-10-01 10:10:00"));
obj7.setSeatByNumber(true);
obj7.setShowTime(StringUtils.parseDateTime("2017-10-31 08:10:00"));
obj7.setStatus(20L);
List<AlibabaDamaiBtoyunSyncPerformanceRequest.VenueImageDto> list10 = new ArrayList<AlibabaDamaiBtoyunSyncPerformanceRequest.VenueImageDto>();
AlibabaDamaiBtoyunSyncPerformanceRequest.VenueImageDto obj11 = new AlibabaDamaiBtoyunSyncPerformanceRequest.VenueImageDto();
list10.add(obj11);
obj11.setVenueImage("11111");
obj11.setImageType(11L);
list8.setVenueImages(list10);
obj1.setPerformances(list6);
List<AlibabaDamaiBtoyunSyncPerformanceRequest.ItemDto> list13 = new ArrayList<AlibabaDamaiBtoyunSyncPerformanceRequest.ItemDto>();
AlibabaDamaiBtoyunSyncPerformanceRequest.ItemDto obj14 = new AlibabaDamaiBtoyunSyncPerformanceRequest.ItemDto();
list13.add(obj14);
obj14.setColor("#FFFFFF");
obj14.setExtendInfo("无");
obj14.setId("111111");
obj14.setName("100元");
obj14.setPerformanceId("222222");
obj14.setProjectId("333333");
obj14.setRemark("无");
obj14.setStatus(1L);
obj14.setStockNumber(2L);
obj14.setType(1L);
obj14.setUnitPriceOfFen(10000L);
obj14.setPackageType(1L);
obj1.setPrices(list13);
obj1.setProjectId("333333");
List<AlibabaDamaiBtoyunSyncPerformanceRequest.SaleRuleDto> list16 = new ArrayList<AlibabaDamaiBtoyunSyncPerformanceRequest.SaleRuleDto>();
AlibabaDamaiBtoyunSyncPerformanceRequest.SaleRuleDto obj17 = new AlibabaDamaiBtoyunSyncPerformanceRequest.SaleRuleDto();
list16.add(obj17);
obj17.setEticketType("1");
obj17.setPerformanceId("222222");
obj17.setTicketType("1");
obj17.setQrEticketType(0L);
obj17.setTakeTicketType("1");
obj17.setEnterType("2");
obj17.setEnableTicketCert(true);
obj17.setEnableRealNameEnter(true);
obj17.setEnableEticketEnter(true);
obj17.setFromPhoenix(true);
AlibabaDamaiBtoyunSyncPerformanceRequest.TicketCertRuleDto obj19 = new AlibabaDamaiBtoyunSyncPerformanceRequest.TicketCertRuleDto();
obj19.setRuleType(1L);
obj19.setCertTypes("1");
list18.setTicketCertRule(obj19);
obj1.setSaleRules(list16);
obj1.setMessageId("performance-message");
obj1.setSellerId("qazqwer");
req.setPerformanceParam(obj1);
AlibabaDamaiBtoyunSyncPerformanceResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaDamaiBtoyunSyncPerformanceRequest req = new AlibabaDamaiBtoyunSyncPerformanceRequest();
AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceParamDtoDomain obj1 = new AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceParamDtoDomain();
List<AlibabaDamaiBtoyunSyncPerformanceRequest.ItemPackageDtoDomain> list3 = new List<AlibabaDamaiBtoyunSyncPerformanceRequest.ItemPackageDtoDomain>();
AlibabaDamaiBtoyunSyncPerformanceRequest.ItemPackageDtoDomain obj4 = new AlibabaDamaiBtoyunSyncPerformanceRequest.ItemPackageDtoDomain();
list3.Add(obj4);
obj4.Id = "111111";
obj4.ItemDetailId = "111111";
obj4.ItemNumber = 2L;
obj4.Name = "无";
obj1.CombinePrices= list3;
List<AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceDtoDomain> list6 = new List<AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceDtoDomain>();
AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceDtoDomain obj7 = new AlibabaDamaiBtoyunSyncPerformanceRequest.PerformanceDtoDomain();
list6.Add(obj7);
obj7.EndTime = DateTime.Parse(2017-10-31 10:10:00");
obj7.ExtendInfo = "无";
obj7.Id = "111111";
obj7.Name = "周杰伦演唱会";
obj7.ProjectId = "111111";
obj7.SaleEndTime = DateTime.Parse(2017-10-15 10:10:00");
obj7.SaleStartTime = DateTime.Parse(2017-10-01 10:10:00");
obj7.SeatByNumber = true;
obj7.ShowTime = DateTime.Parse(2017-10-31 08:10:00");
obj7.Status = 20L;
List<AlibabaDamaiBtoyunSyncPerformanceRequest.VenueImageDtoDomain> list9 = new List<AlibabaDamaiBtoyunSyncPerformanceRequest.VenueImageDtoDomain>();
AlibabaDamaiBtoyunSyncPerformanceRequest.VenueImageDtoDomain obj10 = new AlibabaDamaiBtoyunSyncPerformanceRequest.VenueImageDtoDomain();
list9.Add(obj10);
obj10.VenueImage = "11111";
obj10.ImageType = 11L;
obj7.VenueImages= list9;
obj1.Performances= list6;
List<AlibabaDamaiBtoyunSyncPerformanceRequest.ItemDtoDomain> list12 = new List<AlibabaDamaiBtoyunSyncPerformanceRequest.ItemDtoDomain>();
AlibabaDamaiBtoyunSyncPerformanceRequest.ItemDtoDomain obj13 = new AlibabaDamaiBtoyunSyncPerformanceRequest.ItemDtoDomain();
list12.Add(obj13);
obj13.Color = "#FFFFFF";
obj13.ExtendInfo = "无";
obj13.Id = "111111";
obj13.Name = "100元";
obj13.PerformanceId = "222222";
obj13.ProjectId = "333333";
obj13.Remark = "无";
obj13.Status = 1L;
obj13.StockNumber = 2L;
obj13.Type = 1L;
obj13.UnitPriceOfFen = 10000L;
obj13.PackageType = 1L;
obj1.Prices= list12;
obj1.ProjectId = "333333";
List<AlibabaDamaiBtoyunSyncPerformanceRequest.SaleRuleDtoDomain> list15 = new List<AlibabaDamaiBtoyunSyncPerformanceRequest.SaleRuleDtoDomain>();
AlibabaDamaiBtoyunSyncPerformanceRequest.SaleRuleDtoDomain obj16 = new AlibabaDamaiBtoyunSyncPerformanceRequest.SaleRuleDtoDomain();
list15.Add(obj16);
obj16.EticketType = "1";
obj16.PerformanceId = "222222";
obj16.TicketType = "1";
obj16.QrEticketType = 0L;
obj16.TakeTicketType = "1";
obj16.EnterType = "2";
obj16.EnableTicketCert = true;
obj16.EnableRealNameEnter = true;
obj16.EnableEticketEnter = true;
obj16.FromPhoenix = true;
AlibabaDamaiBtoyunSyncPerformanceRequest.TicketCertRuleDtoDomain obj17 = new AlibabaDamaiBtoyunSyncPerformanceRequest.TicketCertRuleDtoDomain();
obj17.RuleType = 1L;
obj17.CertTypes = "1";
obj16.TicketCertRule= obj17;
obj1.SaleRules= list15;
obj1.MessageId = "performance-message";
obj1.SellerId = "qazqwer";
req.PerformanceParam_ = obj1;
AlibabaDamaiBtoyunSyncPerformanceResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaDamaiBtoyunSyncPerformanceRequest;
$performance_param = new PerformanceParamDto;
$combine_prices = new ItemPackageDto;
$combine_prices->id="111111";
$combine_prices->item_detail_id="111111";
$combine_prices->item_number="2";
$combine_prices->name="无";
$performance_param->combine_prices = $combine_prices;
$performances = new PerformanceDto;
$performances->end_time="2017-10-31 10:10:00";
$performances->extend_info="无";
$performances->id="111111";
$performances->name="周杰伦演唱会";
$performances->project_id="111111";
$performances->sale_end_time="2017-10-15 10:10:00";
$performances->sale_start_time="2017-10-01 10:10:00";
$performances->seat_by_number="true";
$performances->show_time="2017-10-31 08:10:00";
$performances->status="20";
$venue_images = new VenueImageDto;
$venue_images->venue_image="11111";
$venue_images->image_type="11";
$performances->venue_images = $venue_images;
$performance_param->performances = $performances;
$prices = new ItemDto;
$prices->color="#FFFFFF";
$prices->extend_info="无";
$prices->id="111111";
$prices->name="100元";
$prices->performance_id="222222";
$prices->project_id="333333";
$prices->remark="无";
$prices->status="1";
$prices->stock_number="2";
$prices->type="1";
$prices->unit_price_of_fen="10000";
$prices->package_type="1";
$performance_param->prices = $prices;
$performance_param->project_id="333333";
$sale_rules = new SaleRuleDto;
$sale_rules->eticket_type="1";
$sale_rules->performance_id="222222";
$sale_rules->ticket_type="1";
$sale_rules->qr_eticket_type="0";
$sale_rules->take_ticket_type="1";
$sale_rules->enter_type="2";
$sale_rules->enable_ticket_cert="true";
$sale_rules->enable_real_name_enter="true";
$sale_rules->enable_eticket_enter="true";
$sale_rules->from_phoenix="true";
$ticket_cert_rule = new TicketCertRuleDto;
$ticket_cert_rule->rule_type="1";
$ticket_cert_rule->cert_types="1";
$sale_rules->ticket_cert_rule = $ticket_cert_rule;
$performance_param->sale_rules = $sale_rules;
$performance_param->message_id="performance-message";
$performance_param->seller_id="qazqwer";
$req->setPerformanceParam(json_encode($performance_param));
$resp = $c->execute($req);

XML示例
JSON示例

<alibaba_damai_btoyun_sync_performance_response>
    <result>
        <code>200</code>
        <success>false</success>
        <message>success</message>
        <model>{}</model>
    </result>
</alibaba_damai_btoyun_sync_performance_response>

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>

错误码	错误描述	解决方案

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

开放平台

大麦票务云分销API

alibaba.damai.btoyun.sync.performance (场次数据同步服务)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ