/admin/oauth/clients/{client_id}/secrets
为指定客户端创建一个新密钥(secret_value 仅返回一次)。最多支持2个有效密钥。
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
client_id |
path |
string |
是 | 客户端ID |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 201 | 新密钥(含 secret_value,仅返回一次) | service-oauth/internal/handler/dto.CreateClientSecretDetailResponse |
| 400 | 请求参数错误 | service-core/base/dto.SimpleResponse |
| 401 | 未认证:请提供有效的 Bearer Token | service-core/base/dto.SimpleResponse |
| 403 | 权限不足:需要管理员权限 | service-core/base/dto.SimpleResponse |
| 404 | 客户端不存在或不属于当前租户 | service-core/base/dto.SimpleResponse |
| 409 | 冲突:已达到密钥数量上限(最多2个) | service-core/base/dto.SimpleResponse |
| 500 | 服务内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-oauth/internal/handler/dto.CreateClientSecretDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-oauth/internal/handler/dto.CreateClientSecretResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-oauth/internal/handler/dto.CreateClientSecretResponse
OAuth客户端密钥创建结果,secret_value 仅在此响应中返回一次
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
created_at |
string |
否 | 2026-04-15T10:30:00Z |
||
secret_id |
string |
否 | secret-abc123 |
||
secret_value |
string |
否 | sec_xyz789... |
||
status |
string |
否 | active |