更新一个自建角色

对自建角色进行更新。支持公共模式和集成模式，但集成模式下只支持对自建角色的操作，不支持对第三方同步过来的角色操作。

接口版本：

接口版本	更新时间	版本说明
v2	2022.4.8	初始版本：角色使用 role_no角色组使用 group_no包含 integrate_id、type 字段
v4	2022.6.30	返回值新增字段 status
v5	2022.10.28	在 v4 的基础上，接口请求频率由 5 次/秒提升至 20 次/秒；接口路由修改为 POST corp/role/update

请求地址：https://api.jiandaoyun.com/api/v5/corp/role/update

**请求频率：**20 次/秒

请求方式：POST

请求参数：

参数	类型	是否必需	说明
role_no	Number	是	角色编号
group_no	Number	是	角色组编号
name	String	否	角色名称

请求示例：

{
    "role_no": 2558,
    "group_no": 2547,
    "name": "研发部门"
}

响应内容：

参数	类型	是否必需	说明
role_no	Number	是	角色编号
group_no	Number	否	角色组编号
name	String	是	角色名称
type	Number	是	角色类型：0 ：常规角色1 ：外部角色
status	Number	是	成员状态：0: 未确认的成员1: 已加入
integrate_id	String	否	集成模式同步角色关联 ID，仅在集成模式下返回

返回示例：

{
  "role": {
    "role_no": 2558,
    "group_no": 2547,
    "name": "研发部门",
    "type": 0,
    "status": 1
  }
}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

role_no

number

角色编号

必需

group_no

number

角色组编号

必需

name

string

角色名称

可选

示例

{
    "role_no": 2558,
    "group_no": 2547,
    "name": "研发部门"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

role

object

必需

role_no

integer

角色编号

必需

group_no

integer

角色组编号

可选

name

string

角色名称

必需

type

integer

必需

角色类型： 0 ：常规角色 1 ：外部角色

status

integer

必需

成员状态： 0: 未确认的成员 1: 已加入

integrate_id

string

可选

集成模式同步角色关联 ID，仅在集成模式下返回

示例

{
    "role": {
        "role_no": 2558,
        "group_no": 2547,
        "name": "研发部门",
        "type": 0,
        "status": 1
    }
}

更新一个自建角色