权限-资源树信息

系统的可以操作的资源树数据信息

接口信息

  • 接口地址: {your-site-url}/api/skill/system-user/get-role-resource-tree
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 此接口用于获取系统所有的权限资源树,用于后台用户角色分配权限时使用。资源树为多层树状结构,叶子节点中的 resource 字段即为权限资源标识

认证

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

Header
skill-access-token {your-skill-access-token} (请替换为你自己的 token)

请求参数

无需传参。


请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/system-user/get-role-resource-tree' \
--header 'skill-access-token: {your-skill-access-token}' \
--data-raw ''

返回结果

code200 表示调用成功;code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": {
        "all_resources": [
            {
                "key": "order",
                "sort_order": 1,
                "label": {
                    "cn": "订单",
                    "tw": "订单",
                    "en": "Order"
                },
                "child": [
                    {
                        "key": "manage",
                        "label": {
                            "cn": "待处理订单",
                            "tw": "待处理订单",
                            "en": "Coupon"
                        },
                        "sort_order": 1,
                        "child": [
                            {
                                "key": "view",
                                "label": {
                                    "cn": "查看",
                                    "tw": "查看",
                                    "en": "View"
                                },
                                "sort_order": 1,
                                "resource": "order.manage.view"
                            },
                            {
                                "key": "edit",
                                "label": {
                                    "cn": "管理",
                                    "tw": "管理",
                                    "en": "Edit"
                                },
                                "sort_order": 1,
                                "resource": "order.manage.edit"
                            }
                        ]
                    }
                ]
            }
        ]
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码,200 表示成功
message String 执行结果的文字描述
data Object 返回数据

data 字段

字段 类型 说明
all_resources Array[Object] 系统全部权限资源树,为多层嵌套的树状结构

资源节点字段(all_resources 子项及各级 child 子项)

字段 类型 说明
key string 节点标识
sort_order int 排序值,数值越小越靠前
label Object 多语言标签,格式为 {"cn": "中文", "tw": "繁体中文", "en": "英文"},部分节点可能仅包含英文
child Array[Object] 子节点数组,结构同上。无子节点时该字段不存在
resource string 权限资源标识,如 "order.manage.view"只有叶子节点(无 child 的节点)存在此字段,此即为可分配的具体权限

注意事项

  1. GET 请求,无需传参
  2. 资源树为多层嵌套结构(一级模块 → 二级功能 → 三级操作权限)
  3. 只有叶子节点(没有 child 字段的节点)包含 resource 字段,该字段的值即为权限资源标识,用于角色权限分配
  4. label 为多语言对象,通常包含 cntwen 三种语言,部分节点可能仅包含一种语言
Copyright © fecify.com 2025 all right reserved,powered by Gitbook该文件修订时间: 2026-05-31 09:42:16

results matching ""

    No results matching ""