批量创建 API 用户

POST

/nb/v1/api-users/batch

最后修改时间：2026-09-23 01:32:19

批量创建 API 用户并返回其 API Key（仅创建时返回完整 Key）。仅管理员（ADMIN / SU）可调用，非管理员返回 403
role 支持 DEV / USER（默认 USER）；count 1-100（默认 1）；group_id 可选，指定的用户组需属于当前租户，否则返回 404

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

{
    "role": "USER",
    "count": 2
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://localhost:5013/api/nb/v1/api-users/batch' \
--header 'X-Request-Id: req-local-test-001' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "role": "USER",
    "count": 2
}'

返回响应

🟢201

application/json

创建成功。完整 API Key 仅在本次响应中返回。

Bodyapplication/json

示例

{
    "message": "success",
    "requestId": "req-local-test-001",
    "data": [
        {
            "user_id": "4539c226-7dcd-40ae-becd-6b7f5ee33a91",
            "role": "DEV",
            "group_id": 3,
            "group_name": "Default Group",
            "api_key": "nexent-f33ce5fccafc9c529974acca"
        },
        {
            "user_id": "f0dc0e60-4e9b-43cc-9634-48d21f9d1718",
            "role": "DEV",
            "group_id": 3,
            "group_name": "Default Group",
            "api_key": "nexent-bccd8c37cd6e4cd92a6cfaa1"
        }
    ]
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

修改于 2026-09-23 01:32:19

获取当前智能体当前用户的可用aidp知识库

刷新 API Key