Fecify-角色-详细

接口信息

• 接口地址: {your-site-url}/api/skill/system-role/info
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
• 请求方式: GET
• Content-Type: application/json
• 说明: 获取角色的完整权限详情，包括该角色拥有的权限资源列表以及系统全部的权限资源树（服务端后台、B2C 商家端、B2B 商家端）。

认证

请求头中需要携带 skill-access-token：

请求参数

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/system-role/info?role_id=18' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

code 为 200 表示成功；code 不为 200 表示失败。

成功响应

{
    "code": 200,
    "data": {
        "all_admin_resources": [
            {
                "key": "shop",
                "sort_order": 20,
                "label": "店铺管理",
                "child": [
                    {
                        "key": "shop",
                        "label": "店铺列表",
                        "sort_order": 1,
                        "child": [
                            {"key": "view", "label": "查看", "sort_order": 1, "resource": "shop.shop.view"},
                            {"key": "edit", "label": "管理", "sort_order": 1, "resource": "shop.shop.edit"}
                        ]
                    }
                ]
            },
            {
                "key": "system",
                "sort_order": 50,
                "label": "系统管理",
                "child": [
                    {
                        "key": "role",
                        "label": "角色管理",
                        "sort_order": 1,
                        "child": [
                            {"key": "view", "label": "查看", "resource": "system.role.view"},
                            {"key": "edit", "label": "管理", "resource": "system.role.edit"}
                        ]
                    }
                ]
            }
        ],
        "all_manager_b2c_resources": [
            {
                "key": "order",
                "sort_order": 1,
                "label": {"cn": "订单", "en": "Order"},
                "child": [
                    {
                        "key": "manage",
                        "label": {"cn": "待处理订单", "en": "Pending orders"},
                        "child": [
                            {"key": "view", "label": {"cn": "查看"}, "resource": "order.manage.view"},
                            {"key": "edit", "label": {"cn": "管理"}, "resource": "order.manage.edit"}
                        ]
                    }
                ]
            }
        ],
        "all_manager_b2b_resources": [
            {
                "key": "customer",
                "sort_order": 20,
                "label": {"cn": "顾客", "en": "Customer"},
                "child": [
                    {
                        "key": "b2bcontacts",
                        "label": {"cn": "顾客询盘"},
                        "child": [
                            {"key": "view", "label": {"cn": "查看"}, "resource": "customer.b2bcontacts.view"}
                        ]
                    }
                ]
            }
        ],
        "current_admin_resources": [
            "shop.shop.view", "shop.shop.edit", "system.role.view"
        ],
        "current_manager_b2c_resources": [
            "order.manage.view", "order.manage.edit"
        ],
        "current_manager_b2b_resources": [
            "customer.b2bcontacts.view"
        ],
        "shop_type": 2,
        "current_shop_ids": [347, 346, 345],
        "role_id": "18",
        "name": "vip"
    },
    "message": "success"
}

返回字段说明

data 顶层字段

资源树节点结构

每个资源树节点为三层嵌套结构：

权限资源标识符格式

{模块}.{菜单}.{操作}，如 order.manage.view、system.role.edit。这些标识符出现在 current_*_resources 数组中，表示该角色拥有此权限。

注意事项

1. role_id 通过 Fecify-角色-select下拉条 或 Fecify-角色-列表 获取。
2. all_*_resources 返回的是系统完整的权限树，包含所有可能的权限项。
3. current_*_resources 是扁平数组，仅包含该角色已授权的资源标识符。
4. 编辑角色时，将选中的资源标识符列表提交到 Fecify-角色-更新 或 Fecify-角色-创建。