跳到主要内容

创建小组

本文提供调用「创建小组」接口的操作示例。

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

示例:在空间站创建一个小组

假设你有一个空间站,你想在 “产品研发部” 小组中创建一个名为 “产品组” 的子小组。

你的操作步骤如下:

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

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

  3. 获取 “产品研发部” 小组的 unitId (获取方法

    什么是 unitId?

  4. 打开你电脑上的终端,执行下列代码,向服务器发送查询请求(假设 spaceId 为 spcjXzqVrjaP3,产品研发部小组的 unitId 为 eJ6mP5SbW8hF2Zl4YxRrXyKwDzQcTnN,并且关联角色 “产品策划”,其 unitId 为 bY5nKzT4LrJpHsN3jG7fW2mVcXvq8xQ):

    curl -X POST \
    "https://vika.cn/fusion/v1/spaces/spcjXzqVrjaP3/teams" \
    -H "Authorization: Bearer {你的 API Token}" \
    -H 'Content-Type: application/json' \
    -d '{
    "name":"产品组",
    "sequence":1,
    "parentUnitId":"eJ6mP5SbW8hF2Zl4YxRrXyKwDzQcTnN",
    "roles":["bY5nKzT4LrJpHsN3jG7fW2mVcXvq8xQ"]
    }'
  5. 服务器会返回下列 JSON 数据包,"data" 下的即为新增的小组信息:

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

    {
    "code": 200,
    "message": "SUCCESS",
    "success": true,
    "data": {
    "team": {
    "unitId": "T6dCwJ9zUxYfKpV2kNvMmGtXqL1sHrS",
    "name": "产品组",
    "sequence": 1,
    "parentUnitId": "eJ6mP5SbW8hF2Zl4YxRrXyKwDzQcTnN",
    "roles": [
    {
    "unitId": "bY5nKzT4LrJpHsN3jG7fW2mVcXvq8xQ",
    "name": "产品策划",
    "sequence": 1
    }
    ]
    }
    }
    }