alibaba.damai.mz.user.card.list (会员礼品卡列表)

大麦麦座会员-卡列表接口; 支持礼品卡查询;

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
card_type Number 可选 1
  • 默认值:1
  • 卡类型;1=礼品卡;默认礼品卡
    page_size Number 可选 10
  • 默认值:10
  • 每页条数
    card_state Number 可选 1 卡状态;(1=已启用/激活,2=已禁用,3=已过期,4=已废除);不传返回所有状态的卡
    mz_user_id String 必须 83121114 麦座会员用户id
    page Number 可选 1
  • 默认值:1
  • 当前页数

    响应参数

    名称 类型 示例值 描述
    result ResultData 请求结果
    • └ msg
    • String
    • 成功
    • 提示信息
    • └ code
    • String
    • 200
    • 状态码
    • data
    • CardInfo
    • 卡信息
    • └ mz_user_id
    • String
    • 83121114
    • 麦座用户id
    • └ card_type
    • Number
    • 1
    • 卡类型;1=礼品卡
    • card_pager
    • Pager
    • 卡信息分页
    • └ page
    • Number
    • 1
    • 当前页数
    • └ page_size
    • Number
    • 10
    • 每页条数
    • └ total_row
    • Number
    • 99
    • 总条数
    • └ total_page
    • Number
    • 10
    • 总页数
    • data_list
    • CardVO []
    • 卡信息列表
    • └ card_id
    • String
    • 1291882141
    • 卡id
    • └ card_no
    • String
    • hb188128sh124
    • 卡号
    • └ card_state
    • Number
    • 1
    • 卡状态;(1=已启用/激活,2=已禁用,3=已过期,4=已废除)
    • └ card_init_point
    • Number
    • 18000
    • 卡初始点数;单位:点数
    • └ card_balance_point
    • Number
    • 12000
    • 卡剩余点数 单位:点数
    • └ card_balance_money_fen
    • Number
    • 12000
    • 卡余额金额;单位:分
    • └ validate_starttime
    • String
    • 2020-12-01 11:00:00
    • 礼品卡有效期开始时间;精确到秒,北京时间 UTC-8;格式:yyyy-MM-dd HH:mm:ss;
    • └ validate_endtime
    • String
    • 2020-12-31 11:00:00
    • 礼品卡有效期结束时间;精确到秒,北京时间 UTC-8;格式:yyyy-MM-dd HH:mm:ss;
    • └ success
    • Boolean
    • true
    • 是否成功

    请求示例

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

    响应示例

    • XML示例
    • JSON示例
    <alibaba_damai_mz_user_card_list_response>
        <result>
            <msg>成功</msg>
            <code>200</code>
            <data>
                <mz_user_id>83121114</mz_user_id>
                <card_type>1</card_type>
                <card_pager>
                    <page>1</page>
                    <page_size>10</page_size>
                    <total_row>99</total_row>
                    <total_page>10</total_page>
                    <data_list>
                        <card_v_o>
                            <card_id>1291882141</card_id>
                            <card_no>hb188128sh124</card_no>
                            <card_state>1</card_state>
                            <card_init_point>18000</card_init_point>
                            <card_balance_point>12000</card_balance_point>
                            <card_balance_money_fen>12000</card_balance_money_fen>
                            <validate_starttime>2020-12-01 11:00:00</validate_starttime>
                            <validate_endtime>2020-12-31 11:00:00</validate_endtime>
                        </card_v_o>
                    </data_list>
                </card_pager>
            </data>
            <success>true</success>
        </result>
    </alibaba_damai_mz_user_card_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请求失败 api请求失败
    40100002 请求必须的参数不能为空 请求必须的参数不能为空
    40100003 请求数据不存在 请求数据不存在
    40100005 每页条数参数超出限制值 每页条数参数超出限制值
    40100006 请求必须的参数麦座会员id不能为空 请求必须的参数麦座会员id不能为空

    API工具

    如何获得此API

    FAQ

    返回
    顶部