1. 查询授权
获取授权表里面的符合条件的授权列表
举例
- 获取拥有2号用户在test_ugrp户群里的所有授权,分页查询,以role名降序排序
GET:http://api.xdua.com/usro?uid=2&ugrp=test_ugrp&offset=10&limit=5&order=role:ASC
- 获取拥有某个角色的用户列表
GET:http://api.xdua.com/usro?ugrp=test_ugrp&role=test_role&page=3
- 获取某个角色观察到的用户列表:
GET:http://api.xdua.com/usro?granter=test_ugrp:test_role&page=3
- 获取某用户牵扯的所有授权
GET:http://api.xdua.com/usro?uid=2
- 获取某用户在户群test_ugrp下的所有授权
GET:http://api.xdua.com/usro?uid=2&ugrp=test_ugrp
字段名 |
字段位置 |
字段类型 |
字段说明 |
描述 |
可选 |
apiv |
head |
string |
API版本,默认是1.0.0 |
1.0.0 |
可选 |
Authorization |
head |
string |
客户端保存的鉴权token |
32位md5码 |
必选 |
grantee_id |
query |
String |
用户m5d |
用来查询本用户uid被授予的授权 |
可选 |
grantee_name |
query |
String |
被授用户名 |
用来查询被授权用户名字是这个的授权 |
可选 |
granter_id |
query |
String |
授权人 |
授权人的uid |
可选 |
granter_name |
query |
String |
授权用户名 |
用来查询本用户uid被授予的授权 |
可选 |
granter |
query |
String |
出让角色(授权人角色) |
这个选项用于查询某个管理角色能够看到的所有授权列表。为了能够让granter作为独立的查询元素,granter的写法规定为{$ugrp:$role}的写法。例如: test_ugrp:test_role。 granter指明的ugrp和role会覆盖上面ugrp参数和role参数的效果 |
可选 |
offset |
query |
int |
搜索开始的偏移条件 |
获取授权的开始个数,若不设置默认为0 |
可选 |
limit |
query |
int |
搜索数量 |
获取授权的数量,若不设置默认为20 |
可选 |
page |
query |
int |
搜索页号 |
如果page存在的话,就可以忽略offset和limit的效果 |
可选 |
order |
query |
String |
顺序 |
必须按照"字段:ASC/DESC"方式书写,如 name:DESC,默认的order是inc:DESC |
可选 |
返回数据
成功返回
{
"error": 0,
"reason": "success",
"result": {
"maxpage": 0,
"list": [{
"enabled": "1",
"expire": "-1",
"ugrp_id": "83b1d782",
"role_id": "j27TkSO8",
"role_code": "WccerAdmin",
"id": "J8wqV410",
"note": "这是一个备注",
"granter_name": "dua:辣椒帅",
"grantee_name": "dua:始祖鸟",
"granter_id": "Dt5mvrtU",
"grantee_id": "oy21wsE3",
"ugrp_name": "无人阅读",
"role_name": "爬客管理员",
"ugrp_code": "wikicivi"
}, {
"enabled": "1",
"expire": "-1",
"ugrp_id": "83b1d782",
"role_id": "j27TkSO8",
"role_code": "WccerAdmin",
"id": "r1RF9fUx",
"granter_name": "dua:辣椒帅",
"grantee_name": "dua:宗霖天下",
"granter_id": "Dt5mvrtU",
"grantee_id": "zjxzIen8",
"ugrp_name": "无人阅读",
"role_name": "爬客管理员",
"ugrp_code": "wikicivi"
}, {
"enabled": "1",
"expire": "-1",
"ugrp_id": "83b1d782",
"role_id": "lsVkKpot",
"role_code": "MemberAdmin",
"id": "qqd6OKw6",
"granter_name": "dua:辣椒帅",
"grantee_name": "dua:晓悦",
"granter_id": "Dt5mvrtU",
"grantee_id": "Cim85FPZ",
"ugrp_name": "无人阅读",
"role_name": "会员管理员",
"ugrp_code": "wikicivi"
}]
},
}
失败返回
{
"error": 1,
"reason": "失败原因",
"result": {"失败返回的参考数据"},
}