# 角色列表
# 接口说明
| 项 | 值 |
|---|---|
| URL | /openapi/v1/role/list.json |
| 描述 | 角色列表 |
| 请求方式 | POST |
| 需要登录 | 是 |
| 注意事项 | 无 |
| 其他 | 无 |
# 请求参数说明
| 字段名 | 字段类型 | 说明 | 是否必传 |
|---|---|---|---|
| query | string | 名称或备注模糊查询 | 否 |
| pageDto | object | 分页信息 (可不传) | 否 |
| bizNum | string | 子商户number。多商户模式下可指定查询具体子商户下的数据 | 否 |
# 请求数据
{
"query": "xxx",
"pageDto" : { // 分页信息 (可不传)
"pageSize" : 20, // 每页显示数量 最大100 默认20
"pageNum" : 1 // 页码 (从1开始) 默认1
}
}
# 返回数据
{
"code" : 200,
"msg" : "",
"data" : [
{
"id": 20, // 角色ID
"name": "wang", // 名称
"remark":"110" // 备注
}
],
"pageDto" : {
"pageSize" : 20,
"pageNum" : 1,
"count" : 100,
"totalPageNum" : 5
}
}
# 给员工配置角色
# 接口说明
| 项 | 值 |
|---|---|
| URL | /openapi/v1/role/set.json |
| 描述 | 给员工配置角色 |
| 请求方式 | POST |
| 需要登录 | 是 |
| 注意事项 | 无 |
| 其他 | 无 |
# 请求参数说明
| 字段名 | 字段类型 | 说明 | 是否必传 |
|---|---|---|---|
| configuredUserId | string | 被设置的用户id | 是 |
| roleIds | List | 角色ID不能为空 | 是 |
# 请求数据
{
"configuredUserId": "xxx", // 被设置的用户id
"roleIds" : [1, 2, 4] // 角色ID不能为空
}
# 返回数据
{
"code" : 200,
"msg" : "",
"data" : null,
"pageDto" : null
}