1. 查询角色
获取满足条件的角色
GET:http://api.xdua.com/role?
字段名 | 位置 | 类型 | 字段说明 | 描述 | 可选 |
---|---|---|---|---|---|
apiv | head | string | API版本(默认是1.0.0) | 1.0.0 | 可选 |
Authorization | head | string | 客户端保存的鉴权token | Authorization字符串 | 必选 |
filter | query | string | 筛选字符串 | 筛选条件 | 可选 |
page | query | int | 搜索的页号 | 获取用户群的开始个数,不设置默认为0 | 可选 |
offset | query | int | 搜索开始的偏移条件 | 获取用户群的开始个数,不设置默认为0 | 可选 |
limit | query | int | 搜索数量 | 获取用户群的数量,不设置默认为20,配合page或offset,当page出现的时候,表达pagesize | 可选 |
order | query | string | 顺序 | 必须按照"字段:ASC/DESC"方式书写,如 name:DESC | 可选 |
1.1. 返回数据
成功返回
{
"result": {
"total": 1,
"maxpage": 1,
"list": [{
"id": "oRCe9OdV",
"enabled": "1",
"ugrp_id": "A3bdXNT3",
"cstamp": "2019-03-04 00:07:37",
"name": "管理员",
"usroc": "0",
"code": "god",
"avatar": "http://avatar.xdua.com/defaultrolegod.png?x-oss-process=style/avatarp128",
"granter": "root",
"ugrp_name": "健康手环",
"brief": "户群群主"
}]
},
"error": 0,
"reason": "Success"
}
返回字典含义参考角色详情
失败返回
{
"error": 1,
"reason": "失败原因",
"result": "失败返回的参考数据",
}