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

taobao.sellercenter.subusers.get (查询指定账户的子账号列表)

根据主账号nick查询该账号下所有的子账号列表,只能查询属于自己的账号信息 (主账号以及所属子账号)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nick String 必须 zhangsan 表示卖家昵称

响应参数

名称 类型 示例值 描述
subusers SubUserInfo [] 子账号基本信息列表。具体信息为id、子账号用户名、主账号id、主账号昵称、当前状态值、是否分流
  • └ is_online
  • Number
  • 2
  • 是否参与分流 1不参与 2参与
  • └ sub_id
  • Number
  • 123456
  • 子账号Id
  • └ status
  • Number
  • 1
  • 子账号当前状态 1正常 -1删除 2冻结
  • └ seller_id
  • Number
  • 22222
  • 子账号所属的主账号的唯一标识
  • └ nick
  • String
  • zhangsan:no1
  • 子账号用户名
  • └ seller_nick
  • String
  • zhangsan
  • 主账号昵称
  • └ full_name
  • String
  • 张三
  • 子账号姓名

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SellercenterSubusersGetRequest req = new SellercenterSubusersGetRequest();
req.setNick("zhangsan");
SellercenterSubusersGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<sellercenter_subusers_get_response>
    <subusers>
        <sub_user_info>
            <is_online>2</is_online>
            <sub_id>123456</sub_id>
            <status>1</status>
            <seller_id>22222</seller_id>
            <nick>zhangsan:no1</nick>
            <seller_nick>zhangsan</seller_nick>
            <full_name>张三</full_name>
        </sub_user_info>
    </subusers>
</sellercenter_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.missing-parameter:nick 缺少必要的参数nick 必填参数nick为空;请确保传入的必选参数不为空,请对照参数表
isv.mmp-query-subusers-service-error:system_error 系统异常 联系淘宝小二
isv.invalid-permission:no_permission 您无权查询或操作此用户或者您没有权限管理的权限 用对应的有权限管理的账号登陆
isv.nick-not-exist:user_do 提供的昵称不合法或系统中不存在该昵称的主账户 提供正确的nick

API工具

如何获得此API

FAQ

返回
顶部