alibaba.damai.mz.promotion.list (优惠列表API)

麦座-自建电商网站-优惠列表API;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
event_id String 必须 218381913312 麦座场次id

响应参数

名称 类型 示例值 描述
result ResultData api返回结果
  • └ msg
  • String
  • 成功
  • 提示
  • └ code
  • String
  • 200
  • 状态码
  • data
  • PromotionInfoVO
  • 出参
  • coupon_code_promotion_list
  • CouponCodePromotion4c []
  • 该场次可用的优惠码优惠列表
  • └ promotion_show_info
  • String
  • 满100-30
  • 优惠展示信息
  • └ promotion_name
  • String
  • 优惠100-20
  • 优惠名称
  • └ promotion_type_name
  • String
  • 优惠码
  • 优惠类型名称;
  • └ promotion_type
  • Number
  • 6
  • 优惠类型;1=票品优惠,2=订单优惠,6=优惠码
  • └ code_promotion_id
  • String
  • 12893771883
  • 优惠码优惠id;
  • order_promotion_list
  • OrderPromotion4c []
  • 该场次可用的订单优惠列表;只返回文案,具体金额减免及可选中的优惠 请调用订单渲染api时返回。
  • └ promotion_show_info
  • String
  • 优惠100-20
  • 优惠展示信息
  • └ promotion_name
  • String
  • 优惠100-20
  • 优惠名称
  • └ promotion_type_name
  • String
  • 订单优惠
  • 优惠类型名称;
  • └ promotion_type
  • Number
  • 2
  • 优惠类型;1=票品优惠,2=订单优惠,6=优惠码
  • price_promotion_list
  • PricePromotion4c []
  • 该场次可用的票品优惠列表;只返回文案,具体金额减免 请调用订单渲染api时返回。
  • └ promotion_show_info
  • String
  • 180*2-30
  • 优惠展示信息
  • └ promotion_name
  • String
  • 票品优惠180*2-30
  • 优惠名称
  • └ promotion_type_name
  • String
  • 票品优惠
  • 优惠类型名称;
  • └ promotion_type
  • Number
  • 1
  • 优惠类型;1=票品优惠,2=订单优惠,6=优惠码
  • └ event_id
  • String
  • 218381913312
  • 麦座场次id
  • └ success
  • Boolean
  • true
  • api请求是否成功

请求示例

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

响应示例

  • XML示例
  • JSON示例
<alibaba_damai_mz_promotion_list_response>
    <result>
        <msg>成功</msg>
        <code>200</code>
        <data>
            <coupon_code_promotion_list>
                <coupon_code_promotion4c>
                    <promotion_show_info>满100-30</promotion_show_info>
                    <promotion_name>优惠100-20</promotion_name>
                    <promotion_type_name>优惠码</promotion_type_name>
                    <promotion_type>6</promotion_type>
                    <code_promotion_id>12893771883</code_promotion_id>
                </coupon_code_promotion4c>
            </coupon_code_promotion_list>
            <order_promotion_list>
                <order_promotion4c>
                    <promotion_show_info>优惠100-20</promotion_show_info>
                    <promotion_name>优惠100-20</promotion_name>
                    <promotion_type_name>订单优惠</promotion_type_name>
                    <promotion_type>2</promotion_type>
                </order_promotion4c>
            </order_promotion_list>
            <price_promotion_list>
                <price_promotion4c>
                    <promotion_show_info>180*2-30</promotion_show_info>
                    <promotion_name>票品优惠180*2-30</promotion_name>
                    <promotion_type_name>票品优惠</promotion_type_name>
                    <promotion_type>1</promotion_type>
                </price_promotion4c>
            </price_promotion_list>
            <event_id>218381913312</event_id>
        </data>
        <success>true</success>
    </result>
</alibaba_damai_mz_promotion_list_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 参数非法 参数非法
61001006 分销渠道未授权 分销渠道未授权
61001008 网站渠道未授权 网站渠道未授权
61004001 场次未开售 场次未开售

API工具

如何获得此API

FAQ

返回
顶部