更新角色

本文提供调用「更新角色」接口的操作示例。

提示

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

示例：

假设你有一个空间站，你想把角色 “财务A” 的名字改为 “财务”，并将其排序调整至第 2 位。

你的操作步骤如下：

获取你的 API Token。（获取方法）
获取你的空间站 ID。（获取方法）
获取角色 “财务A” 的 unitId。（获取方法）
什么是 unitId?

打开你电脑上的终端，执行下列代码，向服务器发送查询请求（假设 spaceId 为 spcjXzqVrjaP3，角色 “财务A” 的 unitId 为 pL5rZ6E9vTjXzJ7fK3xSsV2GqNnYyM4）：

cURL

curl -X PUT \
"https://vika.cn/fusion/v1/spaces/spcjXzqVrjaP3/roles/pL5rZ6E9vTjXzJ7fK3xSsV2GqNnYyM4" \
-H "Authorization: Bearer {你的 API Token}" \
-H 'Content-Type: application/json' \
-d '{
  "name":"财务",
  "sequence":2002
}'

服务器会返回下列 JSON 数据包，"data" 下的即为更新后的角色信息：

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

{
   "code": 200,
   "success": true,
   "message": "SUCCESS",
   "data": {
     "role": {
       "unitId": "pL5rZ6E9vTjXzJ7fK3xSsV2GqNnYyM4",
       "name": "财务",
       "sequence": 2002
     }
   }
}

示例：​

示例：