刷新 API Key

POST

/nb/v1/api-keys/refresh

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

吊销目标用户的全部有效 API Key，然后创建并返回一个新 Key（仅创建时返回完整 Key）
仅管理员（ADMIN / SU）可调用，非管理员返回 403；目标用户不存在返回 404

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Header 参数

Body 参数application/json必填

示例

byUserIdbyEmail

{
    "user_id": "66b9acdc-33d1-4f41-909f-131533e52666"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

byUserIdbyEmail

curl --location 'http://localhost:5013/api/nb/v1/api-keys/refresh' \
--header 'X-Request-Id: req-local-test-001' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "user_id": "66b9acdc-33d1-4f41-909f-131533e52666"
}'

返回响应

🟢200

application/json

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

Bodyapplication/json

示例

{
    "message": "success",
    "requestId": "req-local-test-001",
    "data": {
        "user_id": "8e21db88-19c9-44fc-a4ca-cfe88d387b5d",
        "email": "test@138.com",
        "api_key": "nexent-c1c2e993b7b842a99b68243a",
        "revoked_count": 0
    }
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

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

批量创建 API 用户

吊销 API Key