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

为自建角色批量添加成员

POST
/v5/corp/role/add_members

为自建角色批量添加成员#

为自建的角色批量添加成员。支持公共模式和集成模式, 但集成模式下只支持对自建角色的操作,不支持对第三方同步过来的角色操作。
接口版本:
接口版本更新时间版本说明
v22022.4.8初始版本:角色使用 role_no角色组使用 group_no包含 integrate_id、type 字段
v42022.6.30返回值新增字段 status
v52022.10.28在 v4 的基础上,接口请求频率由 5 次/秒提升至 10 次/秒;接口路由修改为 POST corp/role/add_members
**请求地址:**https://api.jiandaoyun.com/api/v5/corp/role/add_members
**请求频率:**10 次/秒
请求方式:POST
请求参数:
参数类型是否必须说明
role_noNumber是角色编号,示例:3
usernamesString[]是员工工号
请求示例:
{
    "role_no": 3,
    "usernames": [
         "fr0005",
         "fr008"
    ]
}
响应内容:
参数类型是否必须说明
statusString否返回请求结果
返回示例:
{
    "status": "success"
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json
role_no
integer 
角色编号,示例:3
必需
usernames
array[string]
员工工号
必需
示例
{
    "role_no": 3,
    "usernames": [
        "fr0005",
        "fr008"
    ]
}

示例代码

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/add_members' \
--header 'Content-Type: application/json' \
--data-raw '{
    "role_no": 3,
    "usernames": [
        "fr0005",
        "fr008"
    ]
}'

返回响应

🟢200成功
application/json
Body
object {0}
示例
{
    "status": "success"
}
上一页
列出角色下的成员
下一页
为自建角色批量移除成员
Built with