接口路径(新):http://api.okayapi.com/api/App/Market_RightsAssign/Assign
接口路径(旧):http://api.okayapi.com/?s=App.Market_RightsAssign.Assign
接口描述: 对自己的软件应用进行权限分配,以下三种组合视为唯一的权限分配组:
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
user_role | String | Optaion | MAX: 20 | 会员分组,小白的会员角色,user表示普通用户,admin表示管理员,同时支持自定义分组 | |
assign_user | String | Optaion | MAX: 32 | 授权的用户,对应小白会员的UUID | |
menu_key | String | Required | MAX: 255 | 客户端软件应用的菜单项,可以是菜单、URL或者其他,用于程序判断 | |
menu_title | String | Optaion | MAX: 100 | 菜单标题,用于备注或界面展示 | |
menu_icon | String | Optaion | MAX: 255 | 菜单图标 | |
menu_sort | Int | Optaion | 0 | 菜单排序,值越小越靠前 |
# 示例1,为用户分组和指定用户分配权限,如分配删除用户权限,请求:
{OKAYAPI_API_HOST}/?s=App.Market_RightsAssign.Assign&user_role=user&assign_user=FDF97454F265E3C5B90A14AA9B0C6B66&menu_key=remove_user&menu_sort=0&app_key={你的app_key}&sign={动态签名}
# 示例2,为用户分组分配权限,如分配删除用户权限(分配后属于该用户分组的都具有此权限),请求:
{OKAYAPI_API_HOST}/?s=App.Market_RightsAssign.Assign&user_role=user&menu_key=remove_user&menu_sort=0&app_key={你的app_key}&sign={动态签名}
# 示例3,为指定用户分配权限,分配后只有该用户拥有此权限,请求:
{OKAYAPI_API_HOST}/?s=App.Market_RightsAssign.Assign&assign_user=FDF97454F265E3C5B90A14AA9B0C6B66&menu_key=remove_user&menu_sort=0&app_key={你的app_key}&sign={动态签名}
# 示例4,在前面的基础上,同时设置菜单操作的菜单图标、标题和排序值,方便菜单列表显示
{OKAYAPI_API_HOST}/?s=App.Market_RightsAssign.Assign&assign_user=FDF97454F265E3C5B90A14AA9B0C6B66&menu_key=remove_user&menu_title=删除用户&menu_icon=icon-delete&menu_sort=10
返回:
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"id": 12
},
"msg": "小白开放接口:App.Market_RightsAssign.Assign"
}
KEY | Type | Description |
---|---|---|
err_code | Int | 操作状态码,0成功,1已存在重复的权限,9插件表单未安装 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
id | Int | 成功分配权限后的ID |
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
user_role | String | Optaion | MAX: 20 | 会员分组,小白的会员角色,user表示普通用户,admin表示管理员,同时支持自定义分组 | |
assign_user | String | Optaion | MAX: 32 | 授权的用户,对应小白会员的UUID | |
menu_key | String | Required | MAX: 255 | 客户端软件应用的菜单项,可以是菜单、URL或者其他,用于程序判断 |
KEY | Type | Description |
---|---|---|
err_code | Int | 操作状态码,0成功,9插件表单未安装 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
接口路径(新):http://api.okayapi.com/api/App/Market_RightsAssign/GetUserRights
接口路径(旧):http://api.okayapi.com/?s=App.Market_RightsAssign.GetUserRights
接口描述: 获取单个用户权限列表,并根据菜单排序值从小到大返回。接口将会自动提取assign_user所在分组的全部权限。最多返回1000组。使用前请先安装用户权限分配插件
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
assign_user | String | Optaion | MAX: 32 | 授权的用户,对应小白会员的UUID |
请求:
{OKAYAPI_API_HOST}/?s=App.Market_RightsAssign.GetUserRights&assign_user=FDF97454F265E3C5B90A14AA9B0C6B66&app_key={你的app_key}&sign={动态签名}
返回(最多1000组):
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": "",
"items": [
{
"menu_key": "add_user",
"menu_title": "添加用户",
"menu_icon": ""
},
{
"menu_key": "remove_user",
"menu_title": "删除用户",
"menu_icon": "icon-delete"
}
]
},
"msg": "小白开放接口:App.Market_RightsAssign.GetUserRights"
}
KEY | Type | Description |
---|---|---|
err_code | Int | 操作状态码,0成功,9插件表单未安装 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
items | Array | 权限列表 |
items[].menu_key | String | 菜单项 |
items[].menu_title | String | 菜单名称 |
items[].menu_icon | String | 菜单图标 |
接口路径(新):http://api.okayapi.com/api/App/Market_RightsAssign/Verify
接口路径(旧):http://api.okayapi.com/?s=App.Market_RightsAssign.Verify
接口描述: 检测单个用户的是否具备某项菜单权限。使用前请先安装用户权限分配插件
Parameter | Type | Required | Default | Note | Description |
---|---|---|---|---|---|
HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
assign_user | String | Optaion | MAX: 32 | 授权的用户,对应小白会员的UUID | |
menu_key | String | Required | MAX: 255 | 客户端软件应用的菜单项,可以是菜单、URL或者其他,用于程序判断 |
请求:
{OKAYAPI_API_HOST}/?s=App.Market_RightsAssign.Verify&assign_user=FDF97454F265E3C5B90A14AA9B0C6B66&menu_key=remove_user&app_key={你的app_key}&sign={动态签名}
返回:
{
"ret": 200,
"data": {
"err_code": 0,
"err_msg": ""
},
"msg": "小白开放接口:App.Market_RightsAssign.Verify"
}
KEY | Type | Description |
---|---|---|
err_code | Int | 操作状态码,0成功,1没有权限,9插件表单未安装 |
err_msg | String | 错误提示信息,err_code非0时参考此提示信息 |
Power by OkayAPI.com Contact us (WA: okayapi OR Email: chanzonghuang@gmail.com).
Timezone: America/New_York Mar/26/2025 07:13:55