更新时间:2025-11-13 GMT+08:00
分享

查询用户权限接口 (checkuserauth)

场景描述

查询用户权限。

接口方法

POST

接口URL

https://域名/apiaccess/CC-Management/v1/dataAuth/checkuserauth,例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-Key

string

True

appKey字段,用户标识

2

Authorization

string

True

鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

userId

String

True

用户ID。

AppCube侧的用户ID或者AICC侧SUM的用户ID,优先配置AppCube侧的用户ID。

2

authIds

List<String>

True

权限ID。

最多配置20个权限ID,多个ID之间以,相隔。

响应说明

  • 响应状态码: 200
    表3 响应体参数

    序号

    名称

    参数类型

    是否必选

    说明

    1

    returnCode

    String

    True

    响应码。

    • 0:成功
    • -1:失败。

    2

    description

    String

    True

    响应结果描述。

    3

    result

    Map<String, boolean>

    True

    是否拥有权限。

    key为authId,value为true/false

  • 响应状态码: 400

    错误的请求:请检查请求路径及参数。

  • 响应状态码: 401

    未授权:1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到:请检查请求的路径。

  • 响应状态码: 500

    业务失败:请依次确认您请求中各参数的取值。

报文样例

请求头:

x-app-key:9******************************3  
Authorization:Bearer e******************************e  
Content-Type:application/json

请求参数:

{
    "userId": "1743391785209458469",
    "authIds": ["80071001002","88001001003002","88001001003002001"]
}

响应参数:

{
    "returnCode": "0",
    "description": "success",
    "data": {
        "80071001002": "true",
        "88001001003002": "true",
        "88001001003002001": "true"
    }
}

相关文档