API 参考
Rotate API Key
轮转指定 API Key，并返回新的明文 Token。
POST
/api/open/v1/keys/{key_id}/rotate接口概览
200api_keys:write
轮转指定 API Key，并返回新的明文 Token。
认证方式
请求头使用：
Authorization: Bearer <token>这个接口所需的 scopes：
api_keys:write路径参数
key_id
string必填要轮转的 API Key ID。
响应
200 - application/json
object
string固定为 open_api.key.rotate。
key
object轮转后的 Key 信息。
id
stringAPI Key ID。
name
stringAPI Key 名称。
environment
enum<string>所属环境。
testlive
scopes
scope[]当前 Key 具备的 scopes。
status
enum<string>Key 状态。
activerevoked
tokenPrefix
stringToken 前缀。
tokenLast4
stringToken 后四位。
maskedToken
string掩码后的 Token 展示值。
createdAt
string创建时间。
updatedAt
string更新时间。
lastUsedAt
string | null最近使用时间。
lastUsedIp
string | null最近使用 IP。
lastUsedUserAgent
string | null最近使用的 User-Agent。
revokedAt
string | null撤销时间。
token
string新签发的明文 Token，只会返回一次。
常见错误
UNAUTHORIZED
error_code缺少或无效的 Bearer Token。
RATE_LIMITED
error_code当前 Token 触发限流。
NOT_FOUND
error_code当前 API Key 不存在，或已被清理。
说明
- 轮转成功后，旧 Token 立即失效。调用方要立刻更新密钥管理系统中的值。
这个页面对你有帮助吗？