新建角色组 - 中望帐号

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Authorization

string

必需

示例值:

Bearer eyJhbGciB5DZtTWYVqa9A

Body 参数application/json

name

string

角色组名称

必需

仅支持英文\数字\常用英文字符

description

string

角色组描述

可选

displayName

string

显示名称

可选

默认角色组名称

isZWSOFT

boolean

是否中望内部组

可选

创建后不可修改，默认false

manager

string

角色组管理员

必需

用户名\邮箱\手机号\guid

示例

{
    "name": "Account.IdsManager",
    "manager": "1f83b688-aba3-4248-acd8-d59c71a8311d",
    "displayName": "Account.IdsManager"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://accounts.zwsoft.cn/api/v1.0/roles/create' \
--header 'Authorization: Bearer eyJhbGciB5DZtTWYVqa9A' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Account.IdsManager",
    "manager": "1f83b688-aba3-4248-acd8-d59c71a8311d",
    "displayName": "Account.IdsManager"
}'

返回响应

🟢200成功

application/json

Body

status

integer

返回码

必需

详情请查看全局返回码

message

string

错误详细信息

必需

无错误时，返回：success

error

string | null

错误代号

必需

详情请查看全局返回码

data

array [object {9}]

返回数据

必需

无数据时为空列表

guid

string

角色组GUID

必需

name

string

角色组名称

必需

唯一，可用于索引

description

string

角色组描述

必需

displayName

string

显示名称

必需

memberCount

integer

成员数量

必需

readerCount

integer

可读用户数量

必需

manager

string | null

角色管理员GUID

必需

members

array[string] | null

角色成员GUID

必需

readers

array[string] | null

可读用户GUID

必需

示例

{
    "status": 0,
    "message": "success",
    "error": null,
    "data": [
        {
            "members": [
                "5197764f-4b4b-48b6-9452-4028e27c197e"
            ],
            "readers": [],
            "guid": "6ce71335-99d2-4019-96ca-c6163467ca68",
            "isZWSOFT": false,
            "name": "Account.IdsManager",
            "displayName": "Account.IdsManager",
            "description": "",
            "memberCount": 2,
            "readerCount": 0,
            "manager": "1f83b688-aba3-4248-acd8-d59c71a8311d"
        }
    ]
}