轮换项目 API 密钥

POST

/v1/api-keys/{apiKeyId}/rotate

在同一事务中创建替代密钥并吊销旧密钥。新密钥明文只在本次响应中展示一次。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢201

application/json

密钥轮换成功，新的完整明文只展示一次。

Bodyapplication/json

示例

{
    "id": "key_fedcba9876543210fedcba9876543210",
    "name": "ERP 生产调用",
    "keyPrefix": "ys_live_key_fedcba9876543210fedcba9876543210.",
    "scopes": [
        "thread:create",
        "turn:create",
        "usage:read"
    ],
    "status": "active",
    "expiresAt": "2027-01-01T00:00:00.000Z",
    "createdAt": "2026-09-27T03:30:00.000Z",
    "apiKey": "ys_live_key_fedcba9876543210fedcba9876543210.BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB"
}

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🔴500InternalError

修改于 2026-09-27 15:11:45

吊销项目 API 密钥

创建数字员工