Get User’s Applications¶

Get a list of applications that the current user has permission to access through the access token.

Operation Permissions¶

User login to Application Portal is required.
Selecting an OU is required.

Request Format¶

GET http://{apigw-address}/app-portal-service/v2.2/user/app/list

Request Parameters (Header)¶

Name	Mandatory/Optional	Data Type	Description
Authorization	Mandatory	String	The access token (or bearer token). The format of the parameter’s string is Bearer {your token}. Refer to Log In or Refresh Access Token to learn how to get the access token

Response Parameters¶

Name	Data Type	Description
data	Data Struct	The data of the list of apps

Data Struct¶

Name	Data Type	Description
apps	List <AppDTO>	The details of the application

AppDTO List¶

Name	Data Type	Description
id	String	The application ID
identifier	String	The application identifier given by the user
name	String	The application name
description	String	The application description
type	Integer	The application type 0: web application 1: mobile application
createdTime	String	The time the application was created
status	Boolean	The application status under the organization 0: not enabled 1: enabled
order	Integer	The position of the application in the organization. 0 means the first position. The higher the number, the lower the position
url	String	The URL of the application
isShortcut	Boolean	true = this application is a shortcut false = this application is not a shortcut
category	ApplicationCategory Struct	The application category ID and name. For example, “21” represents “Wind” and “22” represents “Solar”. For details on the structure, see ApplicationCategory Struct . For more information on the list of Application Categories, see List of Application Categories
code	String	The application identifier code
nameJson	I18nString	The application name in Json, supporting multiple languages
descriptionJson	I18nString	The application description in Json, supporting multiple languages

ApplicationCategory Struct¶

Name	Data Type	Description
id	Integer	The application category ID
name	String	The application category name

List of Application Categories¶

ID	Name
21	Wind
22	Solar
23	Hydroelectricity
24	Thermal
25	Storage
26	Pile
27	Electricity Sale
28	Distribution Network
29	Micro Intelligent Network
30	Industry Park
31	Smart Building
32	Smart City
33	AI
34	Other
35	Comprehensive
36	Substation

Error Codes¶

Code	Description
31401	Access Token is invalid
31512	Selecting an OU is required

Samples¶

Request Sample¶

url: http://alpha-apim-cn4.eniot.io/app-portal-service/v2.2/user/app/list
headers: {Authorization=yourBearerToken}
method: GET

Return Sample¶

{
    "code":0,
    "data":{
        "apps":[
            {
                "category":{
                    "id":27,
                    "name":"Electricity Sale"
                },
                "code":"Electricity Sale",
                "createdTime":"2019-05-28 07:49:39",
                "description":"Electricity Sale",
                "descriptionJson": {"default": "Electricity Sale"},
                "id":"accessKey",
                "isShortcut":false,
                "name":"Energy assets Mgmt",
                "nameJson": {"default": "Energy assets Mgmt"},
                "order":4,
                "status":false,
                "type":0
            },
            {
                "category":{
                    "id":21,
                    "name":"Wind"
                },
                "code":"Wind",
                "createdTime":"2019-06-19 05:03:32",
                "description":"menu group 5",
                "descriptionJson": {"default": "menu group 5"},
                "id":"accessKey",
                "isShortcut":false,
                "name":"menu group 5",
                "nameJson": {"default": "menu group 5"},
                "order":6,
                "status":true,
                "type":1
            }
        ]
    },
    "message":""
}