页面契约与已保存角色白名单（addon.manage）
/api/v1/addons/{key}/access
GET
/api/v1/addons/{key}/access调用说明
需要 addon.manage，安装前也可读取。所有页面都有可配置的访问方式。visibility=admin 表示仅管理员，visibility=roles 表示指定角色组。
路径与请求头参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| key | path | string | 是 | ^[a-z][a-z0-9_]{1,79}$ |
Axios 请求示例
在已登录后台页面中调用；示例角色 ID 仅用于说明，请替换为当前系统中的实际角色。
javascript
axios.get('/api/v1/addons/ledger_management/access');响应结构示例
以下为结构示例，不是实时接口结果；列表和文档对象可能省略部分项目。
json
{
"code": 0,
"message": "操作成功",
"data": {
"key": "ledger_management",
"pages": [
{
"key": "tasks",
"title": "任务管理",
"route": "/admin/addons/ledger_management/tasks",
"visibility": "roles",
"role_ids": [
3
],
"manage_role_ids": [
3
]
},
{
"key": "fields",
"title": "字段管理",
"route": "/admin/addons/ledger_management/fields",
"visibility": "admin",
"role_ids": [],
"manage_role_ids": []
}
]
}
}响应状态
| HTTP 状态 | 含义 |
|---|---|
| 200 | 成功 |
| 401 | 未登录或会话失效 |
| 403 | 没有权限 |
| 419 | CSRF 令牌无效 |
| 422 | 参数错误 |
| 503 | 数据库结构需要升级 |