POST `/admin/tenants/{tenant_id}/api-keys/{key_id}/rotate`

轮换指定 API Key，生成新 key 并使旧 key 立即失效

租户服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`tenant_id`	`path`	`string`	是				租户ID
`key_id`	`path`	`string`	是				API Key ID

响应

状态	描述	Schema
200	新API Key	`dto.DataResponse-service-tenant/internal/handler/dto/RotateApiKeyResponse`
400	请求参数错误	`service-core/base/dto.SimpleResponse`
401	未认证	`service-core/base/dto.SimpleResponse`
403	权限不足	`service-core/base/dto.SimpleResponse`
404	API Key未找到	`service-core/base/dto.SimpleResponse`
500	服务器内部错误	`service-core/base/dto.SimpleResponse`

引用的 Schema

dto.DataResponse-service-tenant/internal/handler/dto/RotateApiKeyResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`data`	`service-tenant/internal/handler/dto.RotateApiKeyResponse`	否
`message`	`string`	否
`timestamp`	`string`	否

service-core/base/dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-tenant/internal/handler/dto.RotateApiKeyResponse

字段	类型	必填	示例	约束	描述
`api_key`	`string`	否	`tk_f6e7d8c9a0b1...`
`created_at`	`string`	否	`2026-05-12T16:00:00Z`
`id`	`string`	否	`tak_001`
`key_prefix`	`string`	否	`tk_f6e7d8c9`
`message`	`string`	否	`请立即保存新API Key，旧Key已失效`

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓