1. 查询授区
获取授区表里面的符合条件的授区列表
GET:http://api.xdua.com/usrz?
只有root有权限
举例
- 获取拥有2号用户在test_ugrp户群里的所有授区,分页查询,以role名降序排序 GET:http://api.xdua.com/usrz?uid=2&ugrp=test_ugrp&offset=10&limit=5&order=role:ASC
- 获取拥有某个角色的用户列表 GET:http://api.xdua.com/usrz?ugrp=test_ugrp&role=test_role&page=3
- 获取某个角色观察到的用户列表: GET:http://api.xdua.com/usrz?granter=test_ugrp:test_role&page=3
- 获取某用户牵扯的所有授区 GET:http://api.xdua.com/usrz?uid=2
- 获取某用户在户群test_ugrp下的所有授区 GET:http://api.xdua.com/usrz?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",
"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": {"失败返回的参考数据"},
}