获取角色的成员和小组

本文提供调用「获取角色的成员和小组」接口的操作示例。

提示

仅支持企业级的空间站使用(了解更多)
仅支持空间站的主管理员，以及拥有角色管理权限的子管理员使用

示例：获取指定角色下的所有成员和小组

角色包含具有相同功能的成员和团队。

例如，名为“产品经理”的角色包含产品管理团队和产品经理成员，了解角色

假设你有一个空间站，你想获取指定角色 “产品策划” 下的所有成员和小组

你的操作步骤如下：

获取你的 API Token。（获取方法）
获取你的空间站 ID。（获取方法）
获取角色 “产品策划” 的 unitId。（获取方法）
什么是 unitId?
打开你电脑上的终端，执行下列代码，向服务器发送查询请求（假设 spaceId 为 spcjXzqVrjaP3，“产品策划” 角色的 unitId 是 bV1wL8uG5iZnXz9xR7rMjYsKfPpTcHq）：
- cURL
curl -X GET \ "https://vika.cn/fusion/v1/spaces/spcjXzqVrjaP3/roles/bV1wL8uG5iZnXz9xR7rMjYsKfPpTcHq/units" \ -H "Authorization: Bearer {你的 API Token}"

服务器会返回下列 JSON 数据包，"data" 下的即为角色下的小组和成员数据：

有关返回结果中各参数的含义，可查看 API 手册。

{
  "code": 200,
  "message": "SUCCESS",
  "success": true,
  "data": {
    "members": [
       {
         "unitId": "K2QmXjH1tLzSsZbYyVWv6gUoP9wN7pC",
         "name": "小明",
         "mobile": {
             "number": "14567890123",
             "areaCode": "+86"
         }
         "email": "test3@vikadata.com",
         "avatar": "https://s4.vika.cn/public/2023/05/16/d2d74a23dabb4700a91594fbc975fd06",
         "status": 1,
         "type": "Member",
         "teams": [{
             "unitId": "aDfT7yGpJ5rVcN2xZ8nQzKuWkMl4SbH",
             "name": "产品组",
             "sequence": 3,
             "parentUnitId": "0"
         }],
         "roles": [{
             "unitId": "bV1wL8uG5iZnXz9xR7rMjYsKfPpTcHq",
             "name": "产品策划",
             "sequence": 1         
         }]
       }
     ],
     "teams": [
     {
       "unitId": "VS1SejiywaMWbiGMEHAohh62T9EPmmlh",
       "name": "team A",
       "sequence": 1,
       "parentUnitId": "0",
       "roles": [
         {
             "unitId": "bV1wL8uG5iZnXz9xR7rMjYsKfPpTcHq",
             "name": "产品策划",
             "sequence": 1
         }
       ]
     },
     {
       "unitId": "bG9xSdV1fR6pMlN2tJyXkZzW5TjHcK4",
       "name": "team B",
       "sequence": 2,
       "parentUnitId": "0",
       "roles": [
         {
             "unitId": "bV1wL8uG5iZnXz9xR7rMjYsKfPpTcHq",
             "name": "产品策划",
             "sequence": 1
         }
       ]
     }
   ]
  }
}

示例：获取指定角色下的所有成员和小组​

示例：获取指定角色下的所有成员和小组