批量创建用户

POST

/users:create

批量创建用户并分配角色。

如需同时配置 YiAsk 数据行权限，请使用 /yiask_roles:updateOrCreateWithPermissions 接口中的 users[].dataRowScope。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

[
    {
        "nickname": "张三",
        "username": "zhangsan",
        "email": "zhangsan@example.com",
        "phone": "13800138001",
        "password": "Password123!",
        "roles": [
            "storeOwner"
        ]
    },
    {
        "nickname": "李四",
        "username": "lisi",
        "email": "lisi@example.com",
        "phone": "13800138002",
        "password": "Password123!",
        "roles": [
            "storeOwner"
        ]
    }
]

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/users:create' \
--header 'X-SPACES: default' \
--header 'X-SPACES: {{space}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "nickname": "张三",
        "username": "zhangsan",
        "email": "zhangsan@example.com",
        "phone": "13800138001",
        "password": "Password123!",
        "roles": [
            "storeOwner"
        ]
    },
    {
        "nickname": "李四",
        "username": "lisi",
        "email": "lisi@example.com",
        "phone": "13800138002",
        "password": "Password123!",
        "roles": [
            "storeOwner"
        ]
    }
]'

返回响应

🟢200成功

创建成功

该响应没有 Body

修改于 2026-03-27 07:29:34

根据用户 ID 获取用户完整信息

更新数据范围