alibaba.damai.mz.user.couponcode.list (会员优惠码列表API)

麦座-自建电商网站-会员优惠码列表API; 1、只返回有效的优惠码。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_size Number 可选 10
  • 默认值:10
  • 每页条数;默认=10
    mz_user_id String 必须 2938131412 麦座用户id
    page Number 可选 1
  • 默认值:1
  • 当前页码;默认=1
    coupon_code_state Number 可选 1 优惠码状态;1=可用,2=不可用;默认查所有

    响应参数

    名称 类型 示例值 描述
    result ResultData api返回结果
    • └ msg
    • String
    • 成功
    • 提示
    • └ code
    • String
    • 200
    • 状态码
    • data
    • Pager
    • 出参
    • data_list
    • UserCouponCodeVO []
    • 优惠码列表
    • └ coupon_code_rule_list
    • String []
    • 满100-20
    • 优惠码规则列表
    • └ coupon_code_expire_time
    • String
    • 2020-10-21 17:30:00
    • 优惠码过期时间;精确到秒;格式:格式:yyyy-MM-dd HH:mm:ss;若为空说明不限制过期时间
    • └ coupon_code_use_type
    • String
    • 1
    • 优惠码使用类型;1=仅可单次使用,2=可多次使用
    • └ coupon_code_use_state
    • String
    • 2
    • 优惠码使用状态;1=已使用,2=未使用,3=超额停用;promotionState=1且couponCodeUseState=2同时满足时,此优惠码才可使用
    • └ promotion_state
    • String
    • 1
    • 优惠码所属优惠状态;1=启用,2=禁用
    • └ coupon_code_name
    • String
    • 满100-20
    • 优惠码名称;
    • └ mz_user_id
    • String
    • 2938131412
    • 麦座用户id
    • └ coupon_code
    • String
    • hxnh193uuqh131
    • 优惠码code
    • └ coupon_code_start_time
    • String
    • 2020-10-21 17:30:00
    • 优惠码开始时间
    • └ code_promotion_id
    • String
    • 3435001
    • 优惠码优惠id
    • coupon_project_vos
    • CouponProjectVO []
    • 可使用的项目场次信息列表
    • └ project_id
    • String
    • 123883213124
    • 可使用的项目id
    • └ event_ids
    • String []
    • 1131231231,939218314
    • 可使用的场次ids
    • └ total_page
    • String
    • 2
    • 总页数
    • └ total_row
    • String
    • 19
    • 总记录数
    • └ page_size
    • String
    • 10
    • 每页条数
    • └ page
    • String
    • 1
    • 当前页码
    • └ success
    • Boolean
    • true
    • api请求是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaDamaiMzUserCouponcodeListRequest req = new AlibabaDamaiMzUserCouponcodeListRequest();
    req.setPageSize(10L);
    req.setMzUserId("2938131412");
    req.setPage(1L);
    req.setCouponCodeState(1L);
    AlibabaDamaiMzUserCouponcodeListResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_damai_mz_user_couponcode_list_response>
        <result>
            <msg>成功</msg>
            <code>200</code>
            <data>
                <data_list>
                    <user_coupon_code_v_o>
                        <coupon_code_rule_list>
                            <string>满100-20</string>
                        </coupon_code_rule_list>
                        <coupon_code_expire_time>2020-10-21 17:30:00</coupon_code_expire_time>
                        <coupon_code_use_type>1</coupon_code_use_type>
                        <coupon_code_use_state>2</coupon_code_use_state>
                        <promotion_state>1</promotion_state>
                        <coupon_code_name>满100-20</coupon_code_name>
                        <mz_user_id>2938131412</mz_user_id>
                        <coupon_code>hxnh193uuqh131</coupon_code>
                        <coupon_code_start_time>2020-10-21 17:30:00</coupon_code_start_time>
                        <code_promotion_id>3435001</code_promotion_id>
                        <coupon_project_vos>
                            <coupon_project_v_o>
                                <project_id>123883213124</project_id>
                                <event_ids>
                                    <string>1131231231</string>
                                    <string>939218314</string>
                                </event_ids>
                            </coupon_project_v_o>
                        </coupon_project_vos>
                    </user_coupon_code_v_o>
                </data_list>
                <total_page>2</total_page>
                <total_row>19</total_row>
                <page_size>10</page_size>
                <page>1</page>
            </data>
            <success>true</success>
        </result>
    </alibaba_damai_mz_user_couponcode_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>

    错误码解释

    错误码 错误描述 解决方案

    API工具

    如何获得此API

    FAQ

    返回
    顶部