Get App Resources by User and Organization¶

获取用户在应用下有权限的权限点及菜单列表。用户无需登录应用门户。

前提条件¶

OU 已获取当前应用，或该应用为 OU 内自建应用。
用户已拥有该应用对应的权限点和菜单权限，否则返回结果为空。

请求格式¶

GET https://{apigw-address}/app-portal-service/v2.3/user/app/resource/permission

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	OU ID。如何获取 orgId 信息 >>
userId	Query	必需	String	用户 ID。如何获取 userId 信息 >>
appId	Query	必需	String	应用的 Access Key。如何获取 Access Key >>
locale	Query	可选	String	指定以何种语言返回列表信息，支持以下赋值： `en_US`：英语 `zh_CN`：中文 `es_ES`：西班牙语 `ja_JP`：日语 `de_DE`：德语 `pl_PL`：波兰语默认返回英语 `en_US` 的列表信息。

响应参数¶

名称	数据类型	描述
permissions	Permission 结构体	权限点列表。Permission 结构体 >>
menus	Menu 结构体	菜单列表。Menu 结构体 >>

Permission 结构体¶

名称	数据类型	描述
id	String	权限点 ID。
code	String	权限点 code。
name	String	权限点名称。

Menu 结构体¶

名称	数据类型	描述
id	String	菜单 ID。
name	String	菜单名称。
code	String	菜单 code。
displayOrder	Integer	当前菜单在其所在层级内的排序，值为从 1 开始的整数，序号越小的菜单越排在上方。
url	String	菜单 URL。
parentId	String	上级菜单 ID。
children	Menu 结构体	下级菜单详细信息。

错误码¶

代码	描述
31400	可能原因：OU ID 为空，用户名为空，邮箱为空，应用无效等。
31403	用户无权访问该应用的菜单或权限点。
31404	OU 不存在，应用不存在或 OU 未获取此应用。

示例¶

请求示例¶

url: https://{apigw-address}/app-portal-service/v2.3/user/app/resource/permission?orgId=your_org_id&appId=your_access_key&userId=your_user_id

method: GET

返回示例¶

{
    "code": 0,
    "message": "OK",
    "data": {
        "permissions": [
            {
                "id": "your_resource_id",
                "code": "your_resource_code",
                "name": "your_resource_name"
            }
        ],
        "menus": [
            {
                "id": "your_menu_id",
                "code": "your_menu_code",
                "name": "your_menu_name",
                "url": "",
                "displayOrder": 1,
                "parentId": "",
                "children": [
                    {
                        "id": "your_menu_id",
                        "code": "your_menu_code",
                        "name": "your_menu_name",
                        "url": "your_menu_url",
                        "displayOrder": 1,
                        "parentId": "your_parent_menu_id",
                        "children": []
                    },
                    {
                        "id": "your_menu_id",
                        "code": "your_menu_code",
                        "name": "your_menu_name",
                        "url": "your_menu_url",
                        "displayOrder": 2,
                        "parentId": "your_parent_menu_id",
                        "children": []
                    }
                ]
            },
            {
                "id": "your_menu_id",
                "code": "your_menu_code",
                "name": "your_menu_name",
                "url": "your_menu_url",
                "displayOrder": 3,
                "parentId": "",
                "children": []
            }
        ]
    }
}