Help Center/ Customer Engagement Center/ API Reference/ System Configuration API Reference (API Fabric)/ AppCube OU Isolation Interface/ Interface for Querying User Permissions (checkuserauth)
Updated on 2025-11-13 GMT+08:00
View PDF
Share

Interface for Querying User Permissions (checkuserauth)

Scenario Description

Querying user permissions.

Interface Method

POST

Interface URL

https://domain name/apiaccess/CC-Management/v1/dataAuth/checkuserauth. For example, service.besclouds.com

Request Description

Table 1 Request header parameters

No.

Parameter

Parameter Type

Mandatory or Not

Description

1

X-APP-Key

string

True

appKey field, which is the user ID

2

Authorization

string

True

Authentication field. The format is Bearer (space){Value of AccessToken returned by the tokenByAkSk interface}. (A space is required after Bearer.)
Table 2 Request body parameters

No.

Parameter

Parameter Type

Mandatory or Not

Description

1

userId

String

True

User ID.

For user ID on the AppCube or SUM user ID on the AICC, the user ID on the AppCube is preferred.

2

authIds

List<String>

True

Permission ID.

A maximum of 20 permission IDs can be configured. Use commas (,) to separate multiple IDs.

Response Description

  • Status code: 200
    Table 3 Response body parameters

    No.

    Parameter

    Parameter Type

    Mandatory or Not

    Description

    1

    returnCode

    String

    True

    Response code.

    • 0: success
    • -1: failed.

    2

    description

    String

    True

    Response result description.

    3

    result

    Map<String, boolean>

    True

    Whether the user has the permission.

    The key is authId, and the value is true or false
  • Status code: 400

    Incorrect request. Check the request path and parameters.

  • Status code: 401

    Unauthorized operation. 1. Check whether you have purchased related services. 2. Contact customer service to check the status of your account.

  • Status code: 404

    The requested content is not found. Check the request path.

  • Status code: 500

    Business failure. Check the values of parameters in the request.

Message Example

Request header:

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

Request parameters:

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

Response parameters:

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