注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 店铺会员管理API

taobao.crm.members.increment.get.privy (增量获取卖家会员)

增量获取会员列表,接口返回符合查询条件的所有会员。任何状态更改都会返回,最大允许100

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start_modify Date 可选 2000-01-01 00:00:00 卖家修改会员信息的时间起点.
end_modify Date 可选 2000-01-01 00:00:00 卖家修改会员信息的时间终点.如果不填写此字段,默认为当前时间.
page_size Number 可选 10 每页显示的会员数,page_size的值不能超过100,最小值要大于1
grade Number 可选 2
  • 默认值:-1
  • 最大长度:32
  • 会员等级
    current_page Number 必须 5 显示第几页的会员,如果输入的页码大于总共的页码数,例如总共10页,但是current_page的值为11,则返回空白页,最小页数为1

    响应参数

    名称 类型 示例值 描述
    members BasicMember [] 返回当前页的会员列表
    • └ ouid
    • String
    • 123
    • open_uid
    • └ item_num
    • Number
    • 2
    • 购买的宝贝件数
    • └ close_trade_amount
    • String
    • 23.45
    • 交易关闭金额
    • └ group_ids
    • String
    • 162534|263674
    • 分组的id集合字符串
    • └ status
    • String
    • normal
    • 显示会员的状态,normal正常,blacklist黑名单
    • └ relation_source
    • Number
    • 2
    • 关系来源,1交易成功,2未交易成功 ,3 卖家主动吸纳
    • └ trade_amount
    • String
    • 32.56
    • 交易的金额
    • └ grade
    • Number
    • 3
    • 会员等级,0未非会员,其余对应等级名称取grade_name
    • └ close_trade_count
    • Number
    • 3
    • 交易关闭的笔数
    • └ last_trade_time
    • Date
    • 2000-01-01 00:00:00
    • 最后交易的日期
    • └ trade_count
    • Number
    • 3
    • 交易成功的次数
    • └ biz_order_id
    • Number
    • 2635476788
    • 最后一次交易的订单号.注:该字段从2014.4.23之后不再返回.
    • └ grade_name
    • String
    • 至尊会员
    • 等级名称
    total_result Number 1 记录的总条数

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    CrmMembersIncrementGetPrivyRequest req = new CrmMembersIncrementGetPrivyRequest();
    req.setStartModify(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndModify(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setPageSize(10L);
    req.setGrade(2L);
    req.setCurrentPage(5L);
    CrmMembersIncrementGetPrivyResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <crm_members_increment_get_privy_response>
        <members>
            <basic_member>
                <ouid>123</ouid>
                <item_num>2</item_num>
                <close_trade_amount>23.45</close_trade_amount>
                <group_ids>162534|263674</group_ids>
                <status>normal</status>
                <relation_source>2</relation_source>
                <trade_amount>32.56</trade_amount>
                <grade>3</grade>
                <close_trade_count>3</close_trade_count>
                <last_trade_time>2000-01-01 00:00:00</last_trade_time>
                <trade_count>3</trade_count>
                <biz_order_id>2635476788</biz_order_id>
                <grade_name>至尊会员</grade_name>
            </basic_member>
        </members>
        <total_result>1</total_result>
    </crm_members_increment_get_privy_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:grade grade的取值不正确 会员等级的取值范围为[0,1,2,3,4,5,6]
    isv.parameters-mismatch:start_modify-and-end_modify 最早修改日期大于最迟修改日期 检查start_modify和end_modify字段,前者的值不能大于后者
    isp.crmtop-service-unavailable 当前的服务不可用 请稍侯再试
    isv.invalid-permission 当前登录权限不够 检查权限
    isp.service-unavailable 当前服务不可用 请联系ISP接口提供者
    isp.top-remote-unknown-error 当前服务不可用 请联系ISP接口提供者
    isv.invalid-parameter:currentPage 当前页码 输入大于0的数字
    isv.seller-cannot-query 表示该商家不是常用商家,数据未准备好,不支持复杂条件查询。 请至少1天后重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部