权限-角色创建

创建角色

接口信息

• 接口地址: {your-site-url}/api/skill/system-user/create-role
• 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
• 请求方式: POST
• Content-Type: application/json
• 说明: 此接口用于创建权限角色，并给角色分配权限资源

认证

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

请求参数 (JSON Body)

请求示例

cURL

curl --location --request POST '{your-site-url}/api/skill/system-user/create-role' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "test role",
    "resources": [
        "customer.manage.view",
        "customer.manage.edit",
        "customer.contacts.view",
        "customer.contacts.edit",
        "shop.theme.view",
        "shop.theme.edit",
        "shop.menu.view",
        "shop.menu.edit",
        "shop.page.view",
        "shop.page.edit",
        "shop.urlrewrite.view",
        "shop.urlrewrite.edit",
        "shop.createshop.view",
        "shop.createshop.edit"
    ]
}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "shop_id": 15,
        "name": "test role",
        "resources": [
            "customer.manage.view",
            "customer.manage.edit",
            "customer.contacts.view",
            "customer.contacts.edit",
            "shop.theme.view",
            "shop.theme.edit",
            "shop.menu.view",
            "shop.menu.edit",
            "shop.page.view",
            "shop.page.edit",
            "shop.urlrewrite.view",
            "shop.urlrewrite.edit",
            "shop.createshop.view",
            "shop.createshop.edit"
        ],
        "created_at": "1970-01-01 08:33:46",
        "updated_at": "1970-01-01 08:33:46",
        "id": 54
    },
    "message": "success"
}

返回字段说明

data 字段

注意事项

1. name 和 resources 均为必填
2. resources 的值来源于 权限-资源树信息 返回的资源树中叶子节点的 resource 字段。先调用该 API 获取完整资源树，勾选需要的权限后将对应 resource 值放入 resources 数组