jdy
  1. role_group
jdy
  • 开发指南
  • app
    • 用户应用查询接口
      POST
    • 用户表单查询接口
      POST
  • formdata
    • form
      • 表单字段查询接口V5
    • data
      • 查询单条数据接口
      • 查询多条数据接口
      • 新建单条数据接口
      • 新建多条数据接口
      • 修改单条数据接口
      • 修改多条数据接口
      • 删除单条数据接口
      • 删除多条数据接口
  • file
    • 获取文件上传凭证和上传地址接口
      POST
    • 文件上传接口
      POST
  • corp
    • user
      • 获取成员信息接口
      • 添加成员接口
      • 修改成员接口
      • 删除成员接口
      • 批量删除成员接口
      • 增量导入成员接口
    • department
      • (递归)获取部门成员接口
      • (递归)获取部门列表接口
      • 创建部门接口
      • 修改部门接口
      • 删除部门接口
      • 获取集成模式部门编号接口
      • 全量导入部门接口
    • role
      • 列出角色接口
      • 创建一个自建角色
      • 更新一个自建角色
      • 删除一个自建角色
      • 列出角色下的成员
      • 为自建角色批量添加成员
      • 为自建角色批量移除成员
    • role_group
      • 列出自建角色组
        POST
      • 创建自建角色组
        POST
      • 更新自建角色组
        POST
      • 删除自建角色组
        POST
    • guest
      • 列出我连接的企业
      • 列出我连接的企业的对接人
      • 获取我连接的企业对接人的详细信息
  • workflow
    • 获取单条流程表单数据的审批意见
      POST
    • 查询流程实例信息
      POST
    • 结束流程实例
      POST
    • 流程待办查询
      POST
    • 流程待办提交
      POST
    • 流程待办回退
      POST
    • 流程待办转交
      POST
    • 查询流程日志
      POST
    • 激活流程实例
      POST
  1. role_group

更新自建角色组

POST
/v5/corp/role_group/update

更新自建角色组#

更新创建好的角色组信息。支持公共模式和集成模式,但集成模式下只支持对自建角色操作,不支持对第三方同步的角色操作。
接口版本:
接口版本更新时间版本说明
v22022.4.8初始版本:角色使用 role_no角色组使用 group_no包含 integrate_id, type 字段
v42022.6.30返回值新增字段 status
v52022.10.28在 v4 的基础上,接口请求频率由 5 次/秒提升至 20 次/秒;接口路由修改为 POST corp/role_group/update
请求地址:https://api.jiandaoyun.com/api/v5/corp/role_group/update
**请求频率:**20 次/秒
请求方式:POST
请求参数
参数类型是否必须说明
role_group_noInteger是角色组编号
nameString是角色组名称
请求示例:
{
    "role_group_no": 2559,
    "name": "研发部门"
}
响应内容:
参数类型是否必需说明
group_noNumber是角色组编号
nameString是角色组名称
typeNumber是角色组类型0: 常规角色组2: 企业互联外部角色组
statusNumber是1: 使用中
integrate_idString否集成模式同步角色关联 ID,仅在集成模式下返回
响应示例:
{
  "role_group": {
    "group_no": 2559,
    "name": "研发部门",
    "type": 0,
    "status": 1
  }
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
role_group_no
number 
角色组编号
必需
name
string 
角色组名称
必需
示例
{
    "role_group_no": 2559,
    "name": "研发部门"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.jiandaoyun.com/api/v5/corp/role_group/update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "role_group_no": 2559,
    "name": "研发部门"
}'

返回响应

🟢200成功
application/json
Body
role_group
object 
必需
group_no
number 
角色组编号
必需
name
string 
角色组名称
必需
type
number 
必需
角色组类型 0: 常规角色组 2: 企业互联外部角色组
status
number 
1: 使用中
必需
integrate_id
string 
可选
集成模式同步角色关联 ID,仅在集成模式下返回
示例
{
    "role_group": {
        "group_no": 2559,
        "name": "研发部门",
        "type": 0,
        "status": 1
    }
}
上一页
创建自建角色组
下一页
删除自建角色组
Built with