文档中心 > API类目 > 大麦票务云分销API

alibaba.damai.btoyun.sync.activity (优惠活动推送接口)

第三方优惠活动对接票务云

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
activity_dto ActivityDto 必须 优惠对象
  • activity_list
  • ActivityParamDto []
  • 必须
  • 优惠活动list
  • └ id
  • String
  • 必须
  • 123
  • 优惠活动id
  • └ name
  • String
  • 必须
  • 促销优惠
  • 优惠活动名称
  • └ start_time
  • Date
  • 必须
  • 2019-11-12 19:00:00
  • 优惠活动开始时间
  • └ end_time
  • Date
  • 必须
  • 2019-11-12 19:00:00
  • 优惠活动结束时间
  • └ is_limit_fund
  • Number
  • 必须
  • 0
  • 是否限制金额 1 限制,0 不限制
  • └ limit_fund
  • BigDecimal
  • 可选
  • 1
  • 限制金额额度 不限制时 不传此值
  • └ is_limit_buy
  • Number
  • 必须
  • 0
  • 是否限制用户限买数量 1 限制 0 不限制
  • └ limit_buy_num
  • Number
  • 可选
  • 1
  • 限买数量 不限制时 不传此值
  • └ purpose
  • String
  • 必须
  • 促销
  • 优惠活动目的
  • └ dimension
  • Number
  • 必须
  • 1
  • 优惠维度 1 票品,2场次,3 项目,4 全局
  • rule_list
  • ActivityRuleParamDto []
  • 必须
  • 优惠活动下优惠规则集合
  • └ id
  • String
  • 必须
  • 1
  • 优惠规则id
  • └ activity_id
  • String
  • 必须
  • 1
  • 所属优惠活动id
  • └ condition_type
  • Number
  • 可选
  • 1
  • 条件规则 1每满
  • └ condition_num
  • BigDecimal
  • 必须
  • 2
  • 条件规则限制数量 如每满2张减10元 则conditionNum=2
  • └ promotion_action_type
  • Number
  • 可选
  • 1
  • 优惠方式 1, "立减" 2, "折扣"
  • └ promotion_action_num
  • String
  • 必须
  • 10
  • 优惠数量 0.85折 或 20元 (减固定金额时,单位为元)
  • └ rule_desc
  • String
  • 可选
  • 规则描述
  • 规则描述
  • rule_price_list
  • ActivityRulePriceParamDto []
  • 必须
  • 优惠规则下的规则明细集合
  • └ id
  • String
  • 必须
  • 1
  • 规则明细id
  • └ activity_id
  • String
  • 必须
  • 1
  • 所属优惠活动id
  • └ project_id
  • String
  • 必须
  • 1
  • 项目id
  • └ perform_id
  • String
  • 必须
  • 1
  • 场次id
  • └ price_id
  • String
  • 必须
  • 1
  • 票品id
  • └ type
  • Number
  • 必须
  • 1
  • 推送类型 1上线 2下线
  • └ seller_id
  • String
  • 必须
  • 123
  • 商家id
  • └ time_stamp
  • Number
  • 可选
  • 1
  • 时间戳

响应参数

名称 类型 示例值 描述
request_code Number 200 成功
is_success Boolean true 成功
message String 成功 成功
model String 成功 成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiBtoyunSyncActivityRequest req = new AlibabaDamaiBtoyunSyncActivityRequest();
AlibabaDamaiBtoyunSyncActivityRequest.ActivityDto obj1 = new AlibabaDamaiBtoyunSyncActivityRequest.ActivityDto();
List<AlibabaDamaiBtoyunSyncActivityRequest.ActivityParamDto> list3 = new ArrayList<AlibabaDamaiBtoyunSyncActivityRequest.ActivityParamDto>();
AlibabaDamaiBtoyunSyncActivityRequest.ActivityParamDto obj4 = new AlibabaDamaiBtoyunSyncActivityRequest.ActivityParamDto();
list3.add(obj4);
obj4.setId("123");
obj4.setName("促销优惠");
obj4.setStartTime(StringUtils.parseDateTime("2019-11-12 19:00:00"));
obj4.setEndTime(StringUtils.parseDateTime("2019-11-12 19:00:00"));
obj4.setIsLimitFund(0L);
obj4.setLimitFund("1");
obj4.setIsLimitBuy(0L);
obj4.setLimitBuyNum(1L);
obj4.setPurpose("促销");
obj4.setDimension(1L);
List<AlibabaDamaiBtoyunSyncActivityRequest.ActivityRuleParamDto> list7 = new ArrayList<AlibabaDamaiBtoyunSyncActivityRequest.ActivityRuleParamDto>();
AlibabaDamaiBtoyunSyncActivityRequest.ActivityRuleParamDto obj8 = new AlibabaDamaiBtoyunSyncActivityRequest.ActivityRuleParamDto();
list7.add(obj8);
obj8.setId("1");
obj8.setActivityId("1");
obj8.setConditionType(1L);
obj8.setConditionNum("2");
obj8.setPromotionActionType(1L);
obj8.setPromotionActionNum("10");
obj8.setRuleDesc("规则描述");
List<AlibabaDamaiBtoyunSyncActivityRequest.ActivityRulePriceParamDto> list11 = new ArrayList<AlibabaDamaiBtoyunSyncActivityRequest.ActivityRulePriceParamDto>();
AlibabaDamaiBtoyunSyncActivityRequest.ActivityRulePriceParamDto obj12 = new AlibabaDamaiBtoyunSyncActivityRequest.ActivityRulePriceParamDto();
list11.add(obj12);
obj12.setId("1");
obj12.setActivityId("1");
obj12.setProjectId("1");
obj12.setPerformId("1");
obj12.setPriceId("1");
list9.setRulePriceList(list11);
list5.setRuleList(list7);
obj1.setActivityList(list3);
obj1.setType(1L);
obj1.setSellerId("123");
obj1.setTimeStamp(1L);
req.setActivityDto(obj1);
AlibabaDamaiBtoyunSyncActivityResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_btoyun_sync_activity_response>
    <request_code>200</request_code>
    <is_success>true</is_success>
    <message>成功</message>
    <model>成功</model>
</alibaba_damai_btoyun_sync_activity_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工具

如何获得此API

FAQ

返回
顶部