遍历角色的用户

  1. 请求地址:GET /roles/role/{guid}/users

  2. 接口概述:

    遍历指定角色下用户。

  3. 请求参数:

    参数名 参数类型 参数说明 必需 备注
    offset integer 响应结果起始下标 默认0
    limit integer 响应结果的数量 默认50,最大1000

    如何遍历?

    地址参数

    参数名 参数类型 参数说明 必需 备注
    guid string 角色唯一标识符
  4. 请求体:

  5. 请求示例:

    GET /bitanswer/api/roles/role/{guid}/users?limit=1 HTTP/1.1
    Host: back-office-api.bitanswer.cn
    bitkey: ••••••
  6. 响应示例:

    {
       "status": 0,
       "data": {
           "total": 1,
           "items": [
               {
                   "nickName": "nick_name",
                   "name": "login_name",
                   "guid": "xxxxx",
                   "regDate": "2023-10-24 13:28:35",
                   "status": 0
               }
           ]
       }
    }

    响应体说明

批量绑定用户

  1. 请求地址:POST /roles/role/{guid}/users

  2. 接口概述:

    查找指定的角色,为角色批量绑定用户。

  3. 请求参数:

    地址参数

    参数名 参数类型 参数说明 必需 备注
    guid string 角色唯一标识符
  4. 请求体:

    参数名 参数类型 参数说明 必需 备注
    guid string 用户唯一标识符

    参数说明

    请求体以数组形式输入。

  5. 请求示例

    POST /bitanswer/api/roles/role/{guid}/users  HTTP/1.1
    Host: back-office-api.bitanswer.cn
    Content-Type: application/json
    bitkey: ••••••
    
    [
       {
           "guid":"xxxxx1"
       },
       {
           "guid":"xxxxx2"
       }
    ]
  6. 响应示例

    {
       "status": 0,
       "data": {
           "total": 2,
           "items": [
               {
                   "nickName": "nick_name_1",
                   "name": "login_name_1",
                   "guid": "xxxxx1",
                   "regDate": "2023-11-03 13:35:01",
                   "status": 0
               },
               {
                   "nickName": "nick_name_2",
                   "name": "login_name_2",
                   "guid": "xxxxx2",
                   "regDate": "2023-11-07 17:59:12",
                   "status": 0
               }
           ]
       }
    }

    响应体说明

批量解绑用户

  1. 请求地址:DELETE /roles/role/{guid}/users

  2. 接口概述:

    查找指定的角色,为角色批量解绑用户。

  3. 请求参数:

    地址参数

    参数名 参数类型 参数说明 必需 备注
    guid string 角色唯一标识符
  4. 请求体:

    参数名 参数类型 参数说明 必需 备注
    guid string 用户唯一标识符

    参数说明

    请求体以数组形式输入。

  5. 请求示例

    DELETE /bitanswer/api/roles/role/{guid}/users  HTTP/1.1
    Host: back-office-api.bitanswer.cn
    Content-Type: application/json
    bitkey: ••••••
    
    [
       {
           "guid":"xxxxx1"
       },
       {
           "guid":"xxxxx2"
       }
    ]
  6. 响应示例

    {
       "status": 0,
       "data": {
           "total": 2,
           "items": [
               {
                   "nickName": "nick_name_1",
                   "name": "login_name_1",
                   "guid": "xxxxx1",
                   "regDate": "2023-11-03 13:35:01",
                   "status": 0
               },
               {
                   "nickName": "nick_name_2",
                   "name": "login_name_2",
                   "guid": "xxxxx2",
                   "regDate": "2023-11-07 17:59:12",
                   "status": 0
               }
           ]
       }
    }

    响应体说明