1. 查询授权

获取授权表里面的符合条件的授权列表

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

results matching ""

    No results matching ""