跳到主要内容

获取小组列表

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

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

示例:获取空间站的一级小组列表

将空间站比作一个公司,那么空间站里的小组就是公司里的部门

假设你有一个空间站,你想获取空间站的所有一级小组

你的操作步骤如下:

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

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

  3. 打开你电脑上的终端,执行下列代码,向服务器发送查询请求(假设 spaceId 为 spcjXzqVrjaP3,team 的 unitId 为 0 以获取一级小组):

    curl -X GET \
    "https://vika.cn/fusion/v1/spaces/spcjXzqVrjaP3/teams/0/children?pageSize=2&pageNum=1" \
    -H "Authorization: Bearer {你的 API Token}"
  4. 服务器会返回下列 JSON 数据包,"data" 下的即为小组信息:

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

    {
    "code": 200,
    "message": "SUCCESS",
    "success": true,
    "data": {
    "total": 2,
    "pageSize": 2,
    "pageNum": 1,
    "teams": [
    {
    "unitId": "VS1SejiywaMWbiGMEHAohh62T9EPmmlh",
    "name": "team A",
    "sequence": 1,
    "parentUnitId": "0",
    "roles": [
    {
    "unitId": "zJ6TuQvH2RtNfSx9eY7XKgD1oWcE5pV",
    "name": "role A",
    "sequence": 1
    }
    ]
    },
    {
    "unitId": "bG9xSdV1fR6pMlN2tJyXkZzW5TjHcK4",
    "name": "team B",
    "sequence": 2,
    "parentUnitId": "0",
    "roles": [
    {
    "unitId": "zJ6TuQvH2RtNfSx9eY7XKgD1oWcE5pV",
    "name": "role A",
    "sequence": 1
    }
    ]
    }
    ]
    }
    }