批量新增/修改角色

POST

/api/open/enterpriseright/role-manage/v1/external/role/batch

最后修改时间：2024-06-24 06:06:09

责任人：未设置

请求参数

Query 参数

project

string

可选

项目id或者项目编码。可由实施提供或者通过项目列表接口获取(http://aiot.docs.chn-das.com/api-139664251)

默认值:

1192410229407772672

instance

string

实例

可选

Header 参数

Authorization

string

jwt凭证

必需

示例值:

Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJVamdBcm4wcyIsInNlcnZlciI6dHJ1ZSwidXNlcl9uYW1lIjoi5rWL6K-V562W55WlIiwic2NvcGUiOlsic2VydmVyIl0sIm5hbWUiOiLmtYvor5XnrZbnlaUiLCJwcm9qZWN0IjoiNDA5ODE4NDY2MTYwNzA5IiwiZXhwIjoxNjg0ODcxMjYwLCJ0ZW5hbnQiOiJ0NDA5ODE4NDY2MTYwNzA5IiwiY2xpZW50X2lkIjoic3lzIn0._E-RDguiasgicVmdYdOs4dsI_oKVsOremFWLENLzGyI

Body 参数application/json

data

array [object {5}]

数据

必需

string

来源方角色ID

必需

租户下唯一

name

string

角色名称

可选

租户下唯一，新增时不能为空，修改时如果为空则不更新该字段，否则覆盖

orgId

string

来源方组织ID

可选

新增时如果为空则默认挂靠顶级组织节点，修改时如果为空则不更新该字段，否则覆盖

description

string

描述信息

可选

修改时如果为null则不更新该字段，否则覆盖

status

integer

角色状态

可选

0：禁用1：启用。新增时如果为null则默认1，修改时如果为null则不更新该字段，否则覆盖

dataSyncRule

integer

同步规则

必需

1：角色ID存在时更新 2：角色ID存在时跳过不更新。默认值1

示例

{
  "data": [
    {
      "id": "1",
      "name": "系统",
      "orgId": "",
      "description": "",
      "status": 1
    }
  ],
  "dataSyncRule": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://prod-cn.your-api-server.com/api/open/enterpriseright/role-manage/v1/external/role/batch?project=1192410229407772672&instance=' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJVamdBcm4wcyIsInNlcnZlciI6dHJ1ZSwidXNlcl9uYW1lIjoi5rWL6K-V562W55WlIiwic2NvcGUiOlsic2VydmVyIl0sIm5hbWUiOiLmtYvor5XnrZbnlaUiLCJwcm9qZWN0IjoiNDA5ODE4NDY2MTYwNzA5IiwiZXhwIjoxNjg0ODcxMjYwLCJ0ZW5hbnQiOiJ0NDA5ODE4NDY2MTYwNzA5IiwiY2xpZW50X2lkIjoic3lzIn0._E-RDguiasgicVmdYdOs4dsI_oKVsOremFWLENLzGyI' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
            "id": "1",
            "name": "系统",
            "orgId": "",
            "description": "",
            "status": 1
        }
    ],
    "dataSyncRule": 1
}'

返回响应

🟢200成功

application/json

Body

data

array [object {3}]

异常数据

必需

string

来源方角色ID

必需

status

string

错误编码

必需

msg

string

错误描述

必需

示例

{
  "data": [
    {
      "id": "1",
      "status": "ROLE_NAME_EXISTS",
      "msg": "角色名称已存在"
    }
  ]
}

🟠400400响应结构

获取角色列表

批量删除角色