新增一个用户，并为其指定机构

POST

/v4/user/registration

【云管支持版本：1.16.01版本及以上】

请求参数

Header 参数

ctUserId

string

必需

示例值:

Body 参数application/json

users

array [object {10}]

创建组织列表，直接传数组，数组对象为users，具体参数如下

必需

vendor

string

调用方编码

必需

比如集成交付部调用， ctyun-jcjbx-tool

mainSysUserId

integer <int64>

主账户id

可选

userName

string

账户名称

必需

userCode

string

账户账号

必需

登录使用的账户名

password

string

账户密码

必需

传BASE64加密过后的密码

string

账户邮箱

必需

mobilePhone

string

手机号

必需

userDesc

string

用户描述，没有就空

可选

orgId

integer <int64>

账户所属租户（代表用户和组织关系）

可选

默认一级组织

groupCode

string

用户组编码

可选

目前支持3个 VDC
VDC管理员："G-VDC-ADMIN"
VDC 业务员："G-VDC-BIZ"
VDC 只读管理员："G-VDC-ADMIN-RO"
默认VDC 业务员

示例

{
    "users": [
        {
            "vendor": "ctyun-jcjbx-tool",
            "userName": "openapi2222",
            "userCode": "openapi2222",
            "password": "UXEtMTIzNDU2IQ==",
            "email": "j1232222@qq.com",
            "mobilePhone": "13779341111",
            "userDesc": "描述1"
        },
        {
            "vendor": "ctyun-jcjbx-tool",
            "userName": "openapi11111",
            "userCode": "openapi11111",
            "password": "UXEtMTIzNDU2IQ==",
            "email": "j12311111@qq.com",
            "mobilePhone": "13779342222"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v4/user/registration' \
--header 'ctUserId: 8' \
--header 'Content-Type: application/json' \
--data-raw '{
    "users": [
        {
            "vendor": "ctyun-jcjbx-tool",
            "userName": "openapi2222",
            "userCode": "openapi2222",
            "password": "UXEtMTIzNDU2IQ==",
            "email": "j1232222@qq.com",
            "mobilePhone": "13779341111",
            "userDesc": "描述1"
        },
        {
            "vendor": "ctyun-jcjbx-tool",
            "userName": "openapi11111",
            "userCode": "openapi11111",
            "password": "UXEtMTIzNDU2IQ==",
            "email": "j12311111@qq.com",
            "mobilePhone": "13779342222"
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

statusCode

integer

状态码

必需

返回状态码（800 为成功，900 为失败）

description

string

结果描述

必需

返回结果描述

errorCode

string

错误码

必需

错误码

message

string

错误说明

必需

错误说明

returnObj

object

返回数据

必需

返回数据

userID

string | null

用户id

可选

total

integer <int32> | null

数据总数

可选

failedNum

integer <int32> | null

失败数

可选

successNum

integer <int32> | null

成功数

可选

failMap

object | null

错误信息

可选

示例

成功示例异常示例

{
    "description": "成功 X-Trace-ID-->fe08978f594f4db8",
    "errorCode": "SUCCESS",
    "message": "success",
    "returnObj": {
        "failMap": {},
        "failedNum": 0,
        "successNum": 2,
        "total": 2,
        "userID": "156, 157"
    },
    "statusCode": 800
}

修改于 2024-10-24 03:05:41

通过机构id查询该机构本身+子机构

分页查询用户信息-新