Get User’s Applications¶

获取当前用户有权限的应用列表。

前提条件¶

用户已登录应用门户，并进入一个 OU。如有需要，可通过 Log In API 登录应用门户，通过 Choose Organization API 选择 OU。

请求格式¶

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

请求参数（Header）¶

名称	必需/可选	数据类型	描述
Authorization	必需	String	用户登录并选择 OU 后生成的 Access Token，以 Bearer Token 表示，其形式为 `Bearer {your token}`。可通过调用 Log In 或 Refresh Access Token 接口后获取。

响应参数¶

名称	数据类型	描述
apps	AppDTO 结构体	应用详情。AppDTO 结构体 >>

AppDTO 结构体 ¶

名称	数据类型	描述
id	String	应用 ID。
code	String	应用代码。
name	String	应用名称。
description	String	应用描述。
nameJson	I18nString	应用的多语言名称。
descriptionJson	I18nString	应用的多语言描述。
displayName	String	应用的展示名称。
type	Integer	应用类型，`0` 表示 Web 端应用，`1` 表示移动端应用。
createdTime	String	应用创建时间
status	Boolean	应用在 OU 内的状态。`true` 表示启用，`false` 表示未启用。
order	Integer	应用在 OU 中的排序。`0` 表示位于第一位，数字越大，排序越靠后。
url	String	应用的 URL。
isShortcut	Boolean	应用是否为快捷方式。`true` 表示是快捷方式，`1` 表示不是快捷方式。
category	ApplicationCategory 结构体	应用分类 ID，例如 `21` 表示“风电”，`22` 表示“光伏”。有关 ID 和应用分类的对应关系，参见应用分类列表。ApplicationCategory 结构体 >>

ApplicationCategory 结构体¶

名称	数据类型	描述
id	Integer	应用分类 ID。
name	String	应用分类名称。

应用分类列表 ¶

ID	描述
21	风电
22	光伏
23	水电
24	火电
25	综合
26	充电桩
27	售电
28	配网
29	智能微网
30	工业园区
31	智能楼宇
32	智慧城市
33	人工智能
34	其他
35	综合
36	升压站

错误码¶

代码	描述
31401	提供的 Access Token 无效
31512	未选择 OU

示例¶

请求示例¶

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

method: GET

headers: {"Authorization":"Bearer your_token"}

返回示例¶

{
  "code": 0,
  "message": "OK",
  "data": {
    "pagination": null,
    "apps": [
      {
        "id": "accessKey",
        "code": "Electricity_Sale",
        "name": "Electricity Sale",
        "description": "Electricity Sale",
        "nameJson": {
          "default": "Electricity Sale"
        },
        "descriptionJson": {
          "default": "Electricity Sale"
        },
        "displayName": "",
        "type": 0,
        "createdTime": "2024-06-24 03:36:16",
        "status": true,
        "order": 1,
        "url": null,
        "isShortcut": false
        "category": {
          "id": 22,
          "name": "Solar"
        }
      }
    ]
  }
}