权限-资源树信息
系统的可以操作的资源树数据信息
接口信息
- 接口地址:
{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 ''
返回结果
code 为 200 表示调用成功;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 的节点)存在此字段,此即为可分配的具体权限 |
注意事项
- GET 请求,无需传参
- 资源树为多层嵌套结构(一级模块 → 二级功能 → 三级操作权限)
- 只有叶子节点(没有
child字段的节点)包含resource字段,该字段的值即为权限资源标识,用于角色权限分配 label为多语言对象,通常包含cn、tw、en三种语言,部分节点可能仅包含一种语言