分页查询角色

更新时间:2023-06-15 05:02:15

本文介绍分页查询角色的 API。

接口描述

根据条件分页查询角色信息。

接口地址

GET: /v1.0/iot-02/roles

请求参数

参数名类型参数位置是否必填说明
requestRolePageQueryRequestquerytrue角色查询实体

request 说明

参数名类型参数位置是否必填说明
role_codesString false角色标识列表,英文逗号分隔
role_nameString false角色名称
gmt_modified_ascBoolean false是否按照修改时间正序,默认值为 false
  • true:是
  • false:否
page_noInteger false分页页码,默认值为 1
page_sizeInteger false分页页面大小,默认值为 20

返回参数

参数名类型说明
resultPageResponse角色列表返回结果

result 说明

参数名类型说明
totalInteger总数
listList结果集
has_moreBoolean是否有下一页

list 说明

参数名类型说明
role_codeString角色标识
role_nameString角色名称
remarkString备注

请求示例

GET: /v1.0/iot-02/roles?role_codes=aaa,bbb&role_name=roleName&page_no=1&page_size=20&gmt_modified_asc=true

返回示例

{
    "result": {
        "list": [
            {
                "role_code": "roleCodegcnI",
                "remark": "",
                "role_name": "role1"
            },
            {
                "role_code": "roleCode323j",
                "remark": "",
                "role_name": "role2"
            },
            {
                "role_code": "roleCodeSxSF",
                "remark": "",
                "role_name": "role3"
            },
            {
                "role_code": "roleCodeSbqO",
                "remark": "",
                "role_name": "role4"
            }
        ],
        "has_more": true
    }
}

错误码

参考 错误码