alibaba.damai.mz.promotion.detail (票品优惠规则详情API)

大麦麦座票品/订单优惠规则详情接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
promotion_id String 必须 1234 优惠id
event_id String 可选 100011588 使用该优惠的场次ID(分销商必传)

响应参数

名称 类型 示例值 描述
result ResultData 请求结果
  • └ msg
  • String
  • 成功
  • 提示信息
  • └ code
  • String
  • 200
  • 状态码
  • data
  • PromotionDetailVO
  • 票品优惠详情
  • └ promotion_id
  • String
  • 123456
  • 票品优惠id
  • └ name
  • String
  • 满100减5
  • 票品优惠名称
  • └ desc
  • String
  • ¥100票品满1件减¥5
  • 票品优惠规则展示信息
  • rule_list
  • PromotionRuleVO []
  • 票品优惠政策规则列表
  • └ num
  • Number
  • 1
  • 数量满多少享受此优惠,0:代表不限制数量
  • └ price_money_fen
  • Number
  • 10000
  • 票价满多少享受此优惠,0:代表不限制(单位:分)
  • └ receive_money_fen
  • Number
  • 9500
  • 折后总价(单位:分,示例值,不代表真实价格)
  • └ promotion_type
  • Number
  • 1
  • 优惠方式;1=减固定金额,2=打折
  • └ promotion_value
  • Number
  • 500
  • 优惠值(优惠方式为满减时该值必填)。例:1、优惠方式=1时,减7元,此时promotionValue=700(单位:分)
  • └ promotion_rate
  • String
  • 0.85
  • 优惠折扣率(优惠方式为折扣时该值必填)。例:1、优惠方式=2时,打85折,此时promotionValue=0.85
  • └ rule_id
  • String
  • 123
  • 优惠政策规则id
  • price_list
  • PromotionPirce4cVO []
  • 票品优惠(折扣/减免)适用票品列表
  • └ price_id
  • Number
  • 123456
  • 票品id
  • └ price_name
  • String
  • 示例票品
  • 票品名称
  • └ price_type
  • byte
  • 1
  • 票品类型 1普通票 2 固定套票 3自由组合套票
  • └ success
  • Boolean
  • true
  • 请求结果是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDamaiMzPromotionDetailRequest req = new AlibabaDamaiMzPromotionDetailRequest();
req.setPromotionId("1234");
req.setEventId("100011588");
AlibabaDamaiMzPromotionDetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_promotion_detail_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <promotion_id>123456</promotion_id>
            <name>满100减5</name>
            <desc>¥100票品满1件减¥5</desc>
            <rule_list>
                <promotion_rule_v_o>
                    <num>1</num>
                    <price_money_fen>10000</price_money_fen>
                    <receive_money_fen>9500</receive_money_fen>
                    <promotion_type>1</promotion_type>
                    <promotion_value>500</promotion_value>
                    <promotion_rate>0.85</promotion_rate>
                    <rule_id>123</rule_id>
                </promotion_rule_v_o>
            </rule_list>
            <price_list>
                <promotion_pirce4c_v_o>
                    <price_id>123456</price_id>
                    <price_name>示例票品</price_name>
                    <price_type>1</price_type>
                </promotion_pirce4c_v_o>
            </price_list>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_promotion_detail_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>

错误码解释

错误码 错误描述 解决方案
40100000 api未知错误 通用系统异常
40100001 api请求失败 通用业务异常
61001002 数据不存在 数据不存在
61001003 参数非法 参数非法
61008001 优惠规则为空 优惠规则为空
61008002 优惠规则不合法 优惠规则不合法

API工具

如何获得此API

FAQ

返回
顶部