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

taobao.subusers.page (分页获取指定账户的子账号简易信息列表(新isv建议使用taobao.sellercenter.subusers.page接口))

分页获取指定账户的子账号简易信息列表 (新isv接入建议使用taobao.sellercenter.subusers.page接口)

公共参数

请求参数

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

    响应参数

    名称 类型 示例值 描述
    subaccounts SubAccountInfo [] 子账号基本信息
    • └ sub_id
    • Number
    • 2345143124
    • 子账号id
    • └ sub_status
    • Number
    • 1
    • 子账号状态, 1正常 2冻结 3处罚
    • └ user_id
    • Number
    • 2143124312
    • 主账号id
    • └ sub_dispatch_status
    • Boolean
    • 1
    • 1
    • └ sub_owed_status
    • Boolean
    • 1
    • 1
    • └ sub_nick
    • String
    • 子账号登陆nick
    • zhangsan:no1
    • └ user_nick
    • String
    • 主账号登陆nick
    • zhangsan
    • └ sub_name
    • String
    • 小红
    • 员工昵称
    page_size Number 11 isv本次调用传入的页大小
    total_count Number 110 本次调用删选条件下的总子账号数量,除以页大小可得出最大页数
    page_num Number 11 isv本次调用传入的页码

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    SubusersPageRequest req = new SubusersPageRequest();
    req.setUserNick("商家XX账号");
    req.setAccountStatus(0L);
    req.setPageSize(100L);
    req.setPageNum(1L);
    SubusersPageResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <subusers_page_response>
        <subaccounts>
            <sub_account_info>
                <sub_id>2345143124</sub_id>
                <sub_status>1</sub_status>
                <user_id>2143124312</user_id>
                <sub_dispatch_status>1</sub_dispatch_status>
                <sub_owed_status>1</sub_owed_status>
                <sub_nick>子账号登陆nick</sub_nick>
                <user_nick>主账号登陆nick</user_nick>
                <sub_name>小红</sub_name>
            </sub_account_info>
        </subaccounts>
        <page_size>11</page_size>
        <total_count>110</total_count>
        <page_num>11</page_num>
    </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

    返回
    顶部