Files
TimiServerAPI/http/user/role.http
T
2026-07-31 01:03:53 +08:00

114 lines
3.7 KiB
HTTP
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
### RoleController 接口测试
### 在 IDEA 中选择 dev 或 prod 环境后执行
@permissionId =
@roleId =
@roleCode = TEST_ROLE
@roleNameLangId = role.test.name
@roleDescription = 测试角色
@childRoleId =
@authorizedUserId =
@moduleCode = CORE
### 分页查询角色
### 权限:需要 ADMIN 角色 + ROLE_READ 权限
### 前置条件:需要先登录并回填 `user_token`
### 请求参数:Page<Role>,详见 ./http/object/role.md
### 返回参数:PageResult<Role>,详见 ./http/object/role.md
POST {{baseUrl}}/user/role/list
Content-Type: application/json
Token: {{user_token}}
{
"index": 0,
"size": 16,
"likesExample": {
"moduleCode": "{{moduleCode}}"
}
}
### 查询角色详情
### 权限:需要 ADMIN 角色 + ROLE_READ 权限
### 前置条件:需要先登录并回填 `user_token`URL 参数 `id` 必须传有效角色 ID
### 请求参数:无请求体,URL 参数:`id` 为角色 ID
### 返回参数:Role,详见 ./http/object/role.md
POST {{baseUrl}}/user/role/detail?id={{roleId}}
Token: {{user_token}}
### 创建角色
### 权限:需要 ADMIN 角色 + ROLE_CREATE 权限
### 前置条件:需要先登录并回填 `user_token`
### 请求参数:Role,详见 ./http/object/role.md
### 返回参数:无
POST {{baseUrl}}/user/role/create
Content-Type: application/json
Token: {{user_token}}
{
"moduleCode": "{{moduleCode}}",
"code": "{{roleCode}}",
"nameLangId": "{{roleNameLangId}}",
"description": "{{roleDescription}}",
"permissionIdList": ["{{permissionId}}"],
"childRoleIdList": []
}
### 更新角色
### 权限:需要 ADMIN 角色 + ROLE_UPDATE 权限
### 前置条件:需要先登录并回填 `user_token``id` 必须存在
### 请求参数:Role,详见 ./http/object/role.md
### 返回参数:无
POST {{baseUrl}}/user/role/update
Content-Type: application/json
Token: {{user_token}}
{
"id": "{{roleId}}",
"moduleCode": "{{moduleCode}}",
"code": "{{roleCode}}",
"nameLangId": "{{roleNameLangId}}",
"description": "测试角色-已更新",
"permissionIdList": ["{{permissionId}}"],
"childRoleIdList": ["{{childRoleId}}"]
}
### 删除角色
### 权限:需要 ADMIN 角色 + ROLE_DELETE 权限
### 前置条件:需要先登录并回填 `user_token`URL 参数 `id` 必须传有效角色 ID
### 请求参数:无请求体,URL 参数:`id` 为角色 ID
### 返回参数:无
POST {{baseUrl}}/user/role/delete?id={{roleId}}
Token: {{user_token}}
### 查询用户角色
### 权限:需要 ADMIN 角色 + USER_ROLE_READ 权限
### 前置条件:需要先登录并回填 `user_token`URL 参数 `userId` 必须传有效用户 ID
### 请求参数:无请求体,URL 参数:`userId` 为用户 ID
### 返回参数:List<Role>,详见 ./http/object/role.md
POST {{baseUrl}}/user/role/authorized/list?userId={{authorizedUserId}}
Token: {{user_token}}
### 设置用户角色
### 权限:需要 ADMIN 角色 + 同时具备 USER_ROLE_CREATE 和 USER_ROLE_DELETE 权限
### 前置条件:需要先登录并回填 `user_token`
### 请求参数:UserRoleAuthorizeReq,详见 ./http/object/role.md
### 返回参数:无
POST {{baseUrl}}/user/role/authorized/create
Content-Type: application/json
Token: {{user_token}}
{
"userId": "{{authorizedUserId}}",
"moduleCode": "{{moduleCode}}",
"roleIdList": ["{{roleId}}"],
"roleCodeList": ["{{roleCode}}"]
}
### 查询用户已授权权限
### 权限:需要 ADMIN 角色 + USER_ROLE_READ 权限
### 前置条件:需要先登录并回填 `user_token`URL 参数 `userId` 必须传有效用户 ID
### 请求参数:无请求体,URL 参数:`userId` 为用户 ID
### 返回参数:List<Permission>,详见 ./http/object/permission.md
POST {{baseUrl}}/user/role/authorized/permission?userId={{authorizedUserId}}
Token: {{user_token}}