创建或更新角色并同步权限

POST

/yiask_roles:updateOrCreateWithPermissions

创建或更新 YiAsk 角色，同时配置行权限、列权限，并可选地批量创建或更新用户。

users[].dataRowScope 用于声明用户拥有的数据行权限，key 为 schema sid， value 为逗号分隔的 rowId 字符串。服务端会将这些记录同步到 usersYiaskCollections 中间表。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

{
    "name": "storeOwner",
    "title": "店长",
    "users": [
        {
            "username": "zhangsan",
            "nickname": "张三",
            "email": "zhangsan@example.com",
            "phone": "13800138001",
            "password": "Password123!",
            "dataRowScope": {
                "dim_shops_default": "1",
                "dwd_sales_detail_default": "10,11"
            }
        },
        {
            "username": "lisi",
            "nickname": "李四",
            "email": "lisi@example.com",
            "phone": "13800138002",
            "password": "Password123!",
            "dataRowScope": {
                "dwd_sales_detail_default": "2,3,4"
            }
        }
    ],
    "permissions": {
        "dim_shops_default": {
            "rowPermissions": {
                "allowUsers": {
                    "id": "{{ ctx.state.currentUser.id }}"
                }
            },
            "columnPermissions": {
                "view": [
                    "店铺ID",
                    "店铺名称"
                ]
            }
        },
        "dwd_sales_detail_default": {
            "columnPermissions": {
                "view": null
            },
            "rowPermissions": {
                "allowUsers": {
                    "id": "{{ ctx.state.currentUser.id }}"
                }
            }
        }
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/yiask_roles:updateOrCreateWithPermissions' \
--header 'X-SPACES: default' \
--header 'X-SPACES: {{space}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "storeOwner",
    "title": "店长",
    "users": [
        {
            "username": "zhangsan",
            "nickname": "张三",
            "email": "zhangsan@example.com",
            "phone": "13800138001",
            "password": "Password123!",
            "dataRowScope": {
                "dim_shops_default": "1",
                "dwd_sales_detail_default": "10,11"
            }
        },
        {
            "username": "lisi",
            "nickname": "李四",
            "email": "lisi@example.com",
            "phone": "13800138002",
            "password": "Password123!",
            "dataRowScope": {
                "dwd_sales_detail_default": "2,3,4"
            }
        }
    ],
    "permissions": {
        "dim_shops_default": {
            "rowPermissions": {
                "allowUsers": {
                    "id": "{{ ctx.state.currentUser.id }}"
                }
            },
            "columnPermissions": {
                "view": [
                    "店铺ID",
                    "店铺名称"
                ]
            }
        },
        "dwd_sales_detail_default": {
            "columnPermissions": {
                "view": null
            },
            "rowPermissions": {
                "allowUsers": {
                    "id": "{{ ctx.state.currentUser.id }}"
                }
            }
        }
    }
}'

返回响应

🟢200成功

application/json

创建或更新成功

Body

示例

{
    "id": 1,
    "name": "storeOwner",
    "title": "店长",
    "permissions": {
        "dim_shops_default": {
            "rowPermissions": {
                "allowUsers": {
                    "id": "{{ ctx.state.currentUser.id }}"
                }
            },
            "columnPermissions": {
                "view": [
                    "店铺ID",
                    "店铺名称"
                ]
            }
        },
        "dwd_sales_detail_default": {
            "columnPermissions": {
                "view": null
            },
            "rowPermissions": {
                "allowUsers": {
                    "id": "{{ ctx.state.currentUser.id }}"
                }
            }
        }
    }
}

🟠400请求有误

修改于 2026-03-27 07:29:34

配置数据源角色权限

创建数据范围