跳到主要内容

获取小组的成员

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

提示
  • 仅支持企业级的空间站使用(了解更多)
  • 仅支持空间站的主管理员,以及拥有小组管理、成员管理权限的子管理员使用

示例:

假设你有一个小组 “研发组”,你想获取这个小组下的所有成员。

你的操作步骤如下:

  1. 获取你的 API Token。(获取方法

  2. 获取你的空间站 ID。(获取方法

  3. 获取小组 “研发组” 的 unitId。(获取方法

    什么是 unitId?

  4. 打开你电脑上的终端,执行下列代码,向服务器发送查询请求(假设 spaceId 为 spcjXzqVrjaP3,小组的 unitId 为 VS1SejiywaMWbiGMEHAohh62T9EPmmlh, sensitiveData 为 true 以返回用户的邮箱和手机号信息):

    curl -X GET \
    "https://vika.cn/fusion/v1/spaces/spcjXzqVrjaP3/teams/VS1SejiywaMWbiGMEHAohh62T9EPmmlh/members?pageSize=2&pageNum=1&sensitiveData=true" \
    -H "Authorization: Bearer {你的 API Token}"
  5. 服务器会返回下列 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
    }]
    }
    ]
    }
    }