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

taobao.subusers.get (获取指定账户的子账号简易信息列表)

获取主账号下的子账号简易账号信息集合。(只能通过主账号登陆并且查询该属于主账号的子账号信息)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
user_nick String 必须 商家测试账号 主账号用户名

响应参数

名称 类型 示例值 描述
subaccounts SubAccountInfo [] 子账号基本信息
  • └ sub_id
  • Number
  • 100
  • 123456
  • └ sub_status
  • Number
  • 100
  • 1
  • └ user_id
  • Number
  • 100
  • 654321
  • └ sub_dispatch_status
  • Boolean
  • 100
  • true
  • └ sub_owed_status
  • Boolean
  • 100
  • true
  • └ sub_nick
  • String
  • 100
  • zhangsan:no1
  • └ user_nick
  • String
  • 100
  • zhangsan
  • └ sub_name
  • String
  • 100
  • 小红

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SubusersGetRequest req = new SubusersGetRequest();
req.setUserNick("商家测试账号");
SubusersGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<subusers_get_response>
    <subaccounts>
        <sub_account_info>
            <sub_id>100</sub_id>
            <sub_status>100</sub_status>
            <user_id>100</user_id>
            <sub_dispatch_status>100</sub_dispatch_status>
            <sub_owed_status>100</sub_owed_status>
            <sub_nick>100</sub_nick>
            <user_nick>100</user_nick>
            <sub_name>100</sub_name>
        </sub_account_info>
    </subaccounts>
</subusers_get_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.mmp-query-subusers-service-error:system_error 系统异常 联系淘宝小二
isv.missing-parameter:nick 缺少必要的参数nick 传入参数主账号昵称
isv.nick-not-exist:user_do 系统中不存在该昵称的账户 提供正确的主账号nick
isv.invalid-permission:no_permission 您无权查询或操作此用户或者您没有权限管理的权限 用对应的有权限管理的账号登陆

API工具

如何获得此API

FAQ

返回
顶部