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

taobao.sellercenter.user.permissions.get (获取指定用户的权限集合)

获取指定用户的权限集合,并不组装成树。如果是主账号,返回所有的权限列表;如果是子账号,返回所有已授权的权限。只能查询属于自己的账号信息 (如果是主账号,则是主账号以及所属子账号,如果是子账号则是对应主账号以及所属子账号)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nick String 必须 zhangsan:cool 用户标识,次入参必须为子账号比如zhangsan:cool。如果只输入主账号zhangsan,将报错。

响应参数

名称 类型 示例值 描述
permissions Permission [] 权限列表
  • └ permission_code
  • String
  • tgj
  • 注册到权限中心的code值
  • └ permission_name
  • String
  • 宝贝管理
  • 权限名称
  • └ parent_code
  • String
  • zhangsan
  • 父权限code
  • └ is_authorize
  • Number
  • 1
  • 1 :允许授权 2:不允许授权 6:不允许授权但默认已有权限

请求示例

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

响应示例

  • XML示例
  • JSON示例
<sellercenter_user_permissions_get_response>
    <permissions>
        <permission>
            <permission_code>tgj</permission_code>
            <permission_name>宝贝管理</permission_name>
            <parent_code>zhangsan</parent_code>
            <is_authorize>1</is_authorize>
        </permission>
    </permissions>
</sellercenter_user_permissions_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进行校验,未传入nick不允许查询
isv.mmp-query-subusers-service-error:system_error 系统异常 联系淘宝小二
isv.invalid-permission:no_permission 您无权查询或操作此用户或者您没有权限管理的权限 用对应的有权限管理的账号登陆
isv.nick-not-exist:user_do 系统中不存在该昵称的账户 提供正确的nick

API工具

如何获得此API

FAQ

返回
顶部