Fecify-角色-列表

接口信息

• 接口地址: {your-site-url}/api/skill/system-role/list
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
• 请求方式: GET
• Content-Type: application/json
• 说明: 获取角色分页列表，支持按名称筛选。

认证

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

请求参数

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/system-role/list?pageNum=1&pageSize=10&name=vip' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 18,
                "name": "vip",
                "created_at": "2025-08-18 11:56:33",
                "updated_at": "2025-08-18 11:56:33"
            }
        ],
        "total": 1,
        "pageSize": 10,
        "totalPage": 1
    },
    "message": "success"
}

返回字段说明

data 分页字段

list 子项

注意事项

1. name 支持 LIKE 模糊搜索。
2. 角色详情通过 Fecify-角色-详细 获取。