获取小组的成员
本文提供调用「获取小组的成员」接口的操作示例。
提示
- 仅支持企业级的空间站使用(了解更多)
- 仅支持空间站的主管理员,以及拥有小组管理、成员管理权限的子管理员使用
示例:
假设你有一个小组 “研发组”,你想获取这个小组下的所有成员。
你的操作步骤如下:
获取你的 API Token。(获取方法)
获取你的空间站 ID。(获取方法)
获取小组 “研发组” 的 unitId。(获取方法)
打开你电脑上的终端,执行下列代码,向服务器发送查询请求(假设 spaceId 为
spcjXzqVrjaP3
,小组的 unitId 为VS1SejiywaMWbiGMEHAohh62T9EPmmlh
, sensitiveData 为true
以返回用户的邮箱和手机号信息):- cURL
curl -X GET \
"https://vika.cn/fusion/v1/spaces/spcjXzqVrjaP3/teams/VS1SejiywaMWbiGMEHAohh62T9EPmmlh/members?pageSize=2&pageNum=1&sensitiveData=true" \
-H "Authorization: Bearer {你的 API Token}"服务器会返回下列 JSON 数据包,
"data"
下的即为小组下的成员信息:有关返回结果中各参数的含义,可查看 API 手册。
{
"code": 200,
"message": "SUCCESS",
"success": true,
"data": {
"total": 2,
"pageSize": 2,
"pageNum": 1,
"members": [
{
"unitId": "P8eYsXuL6pZ3mT9cN7gVjKwA2hBq4Ft",
"name": "张三",
"mobile": {
"number": "12345678901",
"areaCode": "+86"
},
"email": "test1@vikadata.com",
"avatar": "https://s4.vika.cn/public/2023/05/16/d2d74a23dabb4700a91594fbc975fd06",
"status": 1,
"type": "PrimaryAdmin",
"teams": [{
"unitId": "VS1SejiywaMWbiGMEHAohh62T9EPmmlh",
"name": "研发组",
"sequence": 1,
"parentUnitId": "YN3YT97EPGL9ZA0loc9V2kNQnWb9ivKW"
}],
"roles": [{
"unitId": "c9EQqwN1pOEgjXqKJznPF6xF8t5TYTf0",
"name": "前端研发工程师",
"sequence": 1
}]
},
{
"unitId": "aDfT7yGpJ5rVcN2xZ8nQzKuWkMl4SbH",
"name": "李四"
"mobile": {
"number": "13456789012",
"areaCode": "+86"
}
"email": "test2@vikadata.com",
"avatar": "https://s4.vika.cn/public/2023/05/16/d2d74a23dabb4700a91594fbc975fd06",
"status": 1,
"type": "Member",
"teams": [{
"unitId": "VS1SejiywaMWbiGMEHAohh62T9EPmmlh",
"name": "研发组",
"sequence": 1,
"parentUnitId": "YN3YT97EPGL9ZA0loc9V2kNQnWb9ivKW"
}],
"roles": [{
"unitId": "K2QmXjH1tLzSsZbYyVWv6gUoP9wN7pC",
"name": "后端研发工程师",
"sequence": 2
}]
}
]
}
}