轮换凭据密钥

POST

/v1/credentials/{credentialId}/rotate

原子创建新凭据版本并立即使旧版本不再可用于新调用；secret 仍为只写字段。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

Body 参数application/json必填

示例

{
    "secret": {
        "token": "<replacement-write-only>"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/credentials//rotate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "secret": {
        "token": "<replacement-write-only>"
    }
}'

返回响应

🟢200

application/json

轮换后的凭据元数据。

Bodyapplication/json

示例

{
    "id": "cred_example",
    "externalId": "erp-production",
    "name": "ERP 生产凭据",
    "kind": "bearer",
    "status": "active",
    "metadata": {
        "owner": "platform"
    },
    "currentVersion": 1,
    "fingerprintSuffix": "9a8b7c6d5e4f",
    "createdAt": "2026-09-27T08:00:00.000Z",
    "updatedAt": "2026-09-27T08:00:00.000Z",
    "revokedAt": null
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

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

获取凭据元数据

吊销凭据