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

taobao.sellercenter.subuser.permissions.roles.get (查询指定的子账号的权限和角色信息)

查询指定的子账号的被直接赋予的权限信息和角色信息。
返回对象中包括直接赋予子账号的权限点信息、被赋予的角色以及角色的对应权限点信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
nick String 必须 zhangsan:cool
  • 最大长度:100
  • 子账号昵称(子账号标识)

    响应参数

    名称 类型 示例值 描述
    subuser_permission SubUserPermission 子账号被所拥有的权限
    • roles
    • Role []
    • 子账号被赋予的角色信息(Role)列表。列表中的角色对象只有role_id,role_name,permissions信息
    • └ role_id
    • Number
    • 123456
    • 角色id
    • └ role_name
    • String
    • 发货员
    • 角色名
    • └ description
    • String
    • 发货管理员
    • 角色描述
    • permissions
    • Permission []
    • 所拥有权限
    • └ permission_code
    • String
    • tgj
    • 注册到权限中心的code值
    • └ is_authorize
    • Number
    • 1
    • 1 :允许授权 2:不允许授权 6:不允许授权但默认已有权限
    • └ permission_name
    • String
    • 宝贝管理
    • 权限名称
    • └ parent_code
    • String
    • zhangsan
    • 父权限code
    • permissions
    • Permission []
    • 子账号被直接赋予的权限点列表
    • └ permission_code
    • String
    • tgj
    • 注册到权限中心的code值
    • └ is_authorize
    • Number
    • 1
    • 1 :允许授权 2:不允许授权 6:不允许授权但默认已有权限
    • └ permission_name
    • String
    • 宝贝管理
    • 权限名称
    • └ parent_code
    • String
    • zhangsan
    • 父权限code

    请求示例

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

    响应示例

    • XML示例
    • JSON示例
    <sellercenter_subuser_permissions_roles_get_response>
        <subuser_permission>
            <roles>
                <role>
                    <role_id>123456</role_id>
                    <role_name>发货员</role_name>
                    <description>发货管理员</description>
                    <permissions>
                        <permission>
                            <permission_code>tgj</permission_code>
                            <is_authorize>1</is_authorize>
                            <permission_name>宝贝管理</permission_name>
                            <parent_code>zhangsan</parent_code>
                        </permission>
                    </permissions>
                </role>
            </roles>
            <permissions>
                <permission>
                    <permission_code>tgj</permission_code>
                    <is_authorize>1</is_authorize>
                    <permission_name>宝贝管理</permission_name>
                    <parent_code>zhangsan</parent_code>
                </permission>
            </permissions>
        </subuser_permission>
    </sellercenter_subuser_permissions_roles_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-subuser-permissions-service-error:system_error 系统异常 系统异常
    isv.invalid-permission:no_permission 您无权查询或操作此用户或者您没有权限管理的权限 用对应的有权限管理的账号登陆
    isv.nick-not-exist:sub_user_do 提供的昵称不合法或系统中不存在该昵称的子账户 提供的昵称不合法或系统中不存在该昵称的子账户

    API工具

    如何获得此API

    FAQ

    返回
    顶部