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);

    }
}