文档中心 > API类目 > 子账号管理

taobao.sellercenter.subusers.page (通过主账号登陆态分页查询子账号列表)

通过主账号登陆态分页查询子账号列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nick String 必须 xxx官方工厂 主账号登陆nick
account_status Number 可选 0 可以不传,不传的话和老接口返回数据一样。如果传则根据子账号当前状态筛选 1正常 2冻结 3处罚,如果不传默认都返回
page_size Number 必须 100
  • 默认值:100
  • 页大小,大于1小于200
    page_num Number 必须 1
  • 默认值:1
  • 页码,大于等于1

    响应参数

    名称 类型 示例值 描述
    subusers SubUserInfo [] 子账号基本信息列表。具体信息为id、子账号用户名、主账号id、主账号昵称、当前状态值、是否分流
    • └ is_online
    • Number
    • 2
    • 是否参与分流 1不参与 2参与
    • └ sub_id
    • Number
    • 1
    • 子账号Id
    • └ status
    • Number
    • 1
    • 子账号当前状态 1正常 -1删除 2冻结
    • └ seller_id
    • Number
    • 3124341234
    • 子账号所属的主账号的唯一标识
    • └ nick
    • String
    • 风格店:售后
    • 子账号用户名
    • └ seller_nick
    • String
    • 风格店
    • 主账号昵称
    • └ full_name
    • String
    • 张三
    • 子账号姓名
    page_size Number 100 isv本次调用传入的页大小
    total_count Number 342 本次调用删选条件下的总子账号数量,除以页大小可得出最大页数
    page_num Number 1 isv本次调用传入的页码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    SellercenterSubusersPageRequest req = new SellercenterSubusersPageRequest();
    req.setNick("xxx官方工厂");
    req.setAccountStatus(0L);
    req.setPageSize(100L);
    req.setPageNum(1L);
    SellercenterSubusersPageResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <sellercenter_subusers_page_response>
        <subusers>
            <sub_user_info>
                <is_online>2</is_online>
                <sub_id>1</sub_id>
                <status>1</status>
                <seller_id>3124341234</seller_id>
                <nick>风格店:售后</nick>
                <seller_nick>风格店</seller_nick>
                <full_name>张三</full_name>
            </sub_user_info>
        </subusers>
        <page_size>100</page_size>
        <total_count>342</total_count>
        <page_num>1</page_num>
    </sellercenter_subusers_page_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

    返回
    顶部