CreateUser - 创建用户

通过 OpenAPI 创建用户。

适用版本

企业专属版

服务接入点

获取服务接入点,替换 API 请求语法中的 {domain}

授权信息

产品

资源

所需权限

组织管理

用户

读写

请求语法

POST https://{domain}/oapi/v1/platform/users

请求说明

创建用户

curl -X 'POST' \
  'https://test-domain-***.rdc.aliyuncs.com/oapi/v1/platform/users' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --data '
    {
        "name": "文档测试用户11",
        "username": "doc-test11",
        "password": "password***",
        "email": "doc-test11@example.com",
        "nickName": "昵称11",
        "staffId": "123456",
        "sysDeptIds": ["ebeb5a64-c98c-478a-9d9d-513841da****"]
    }'

请求头(Headers)

x-yunxiao-token string (必选)

个人访问令牌。您可参考个人访问令牌获取。

示例:pt-0fh3****0fbG_35af****0484。

请求参数

name string 必选

显示用户名。

username string 必选

登录账号名。

password string 必选

密码。

email string (可选)

邮箱。

nickName string (可选)

昵称。

staffId string (可选)

工号。

sysDeptIds array[string] (可选)

所属部门,为空时加入根部门。

返回参数

返回示例

{
    "id": "0eddcebb-a9ed-45a9-8225-7d5eff68****",
    "username": "doc-test11",
    "name": "文档测试用户11",
    "nickName": "昵称11",
    "email": "doc-test11@example.com",
    "staffId": "123456",
    "createdAt": "2025-06-13T03:15:09Z"
}

id string

部门 ID。

username string

登录账号名。

name string

显示名称。

nickName string

昵称。

email string

邮箱。

staffId string

工号。

createdAt string

创建时间。

错误码

访问错误码中心查看 API 相关错误码。