Get Users Asset List

Get the asset permissions of users without logging in to Application Portal.

Operation Permissions

In Application Portal, the application must be granted the “Obtain all user permissions in the OU” permission.

Request Format

POST https://{apigw-address}/app-portal-service/v2.2/user/users/assetList

Request Parameters (Body)

Name

Mandatory/Optional

Data Type

Description

organizationId

Mandatory

String

The organization ID. How to get organizationId>>

userIds

Mandatory

List

The list of user IDs.

Response Parameters

Name

Data Type

Description

data

Data Struct

The information about users and their corresponding assets.

Data Struct

Name

Data Type

Description

usersAssets

UsersAssetListResponse Struct

The information about users and their corresponding assets.

UsersAssetListResponse Struct

Name

Data Type

Description

usersUserAssets

UsersUserAssetsDTO Struct

The information about users and their corresponding assets.

userAssets

UserAssetInfoDTO Struct

The asset information.

UsersUserAssetsDTO Struct

Name

Data Type

Description

userId

String

The user ID.

userAssetIds

List

The list of Asset IDs.

UserAssetInfoDTO Struct

Name

Data Type

Description

id

String

The asset ID.

name

I18nString

The asset name.

Error Codes

Code

Description

31400

Errors such as incorrect parameters, empty parameters, character limits exceeded, and so on.

31403

The application has not been granted the “Obtain all user permissions in the OU” permission.

31404

Organization not found.

Samples

Request Sample

url: https://{apigw-address}/app-portal-service/v2.2/user/users/assetList

method: POST

requestBody:
{"organizationId":"yourOrgId","userIds": ["user1","user2","user3"]}

Return Sample

{
    "code": 0,
    "message": "OK",
    "data": {
        "usersUserAssets": [
            {
                "userId": "u15689477086181",
                "userAssetIds": [
                    "zhjAwHTx",
                    "0xQjZr53",
                    "164yFtSp"
                ]
            }
        ],
        "userAssets": [
            {
                "id": "0xQjZr53",
                "name": {
                    "default": "message201"
                }
            },
            {
                "id": "164yFtSp",
                "name": {
                    "default": "message465"
                }
            },
            {
                "id": "zhjAwHTx",
                "name": {
                    "default": "appAssert"
                }
            }
        ]
    }
}

Java SDK Sample

public class AppPortalSdkTest{
    @Test
    public void getUsersAssetList() {
            ArrayList<String> userIds = new ArrayList<>();
            userIds.add("user1");
            userIds.add("user2");
            userIds.add("user3");
            UsersAssetListRequest usersAssetListRequest = new UsersAssetListRequest(userIds,"your_org_id");
            UsersAssetListResponse response = Poseidon.config(PConfig.init().appKey("your_access_key").appSecret("your_secret_key").debug())
                    .url("https://{apigw-address}").getResponse(usersAssetListRequest, UsersAssetListResponse.class);

            System.out.println("List organization res: " + JSON.toJSONString(response));
            assertNotNull("Response should not be null", response);
            assertNotNull("Response data should not be null", response.data);

    }
}