/admin/oauth/clients/{client_id}
更新指定 OAuth 客户端的配置信息(redirect_uris, scopes, grant_types, name, status, JWKS 等)
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
client_id |
path |
string |
是 | 客户端ID |
请求体
Schema: service-oauth/internal/handler/dto.UpdateClientRequest
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
alias |
string |
否 | |||
client_auth_methods |
array of string |
否 | |||
cors_origins |
array of string |
否 | |||
fapi_profile |
string |
否 | |||
grant_types |
array of string |
否 | |||
is_confidential |
boolean |
否 | |||
jwks |
string |
否 | |||
jwks_uri |
string |
否 | |||
logo_url |
string |
否 | |||
name |
string |
否 | |||
post_logout_redirect_uris |
array of string |
否 | |||
privacy_policy |
string |
否 | |||
redirect_uris |
array of string |
否 | |||
scopes |
array of string |
否 | |||
status |
string |
否 | |||
terms_url |
string |
否 | |||
website |
string |
否 |
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 更新成功 | service-oauth/internal/handler/dto.OAuthClientItemDetailResponse |
| 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 |
| 500 | 服务内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-oauth/internal/handler/dto.OAuthClientItem
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
alias |
string |
否 | 小说 |
Alias 显示简称(metadata.alias) | |
client_auth_methods |
string |
否 | ["client_secret_basic","private_key_jwt"] |
||
client_id |
string |
否 | app-123 |
||
cors_origins |
array of string |
否 | ['["https://app.example.com"]'] |
||
created_at |
string |
否 | 2026-04-15T10:30:00Z |
||
deleted_at |
string |
否 | |||
fapi_profile |
string |
否 | fapi1 |
||
grant_types |
array of string |
否 | ['["authorization_code"]'] |
||
id |
string |
否 | client_abc123 |
||
is_confidential |
boolean |
否 | True |
||
jwks_uri |
string |
否 | https://client.example.com/.well-known/jwks.json |
||
logo_url |
string |
否 | https://app.example.com/logo.png |
||
name |
string |
否 | My App |
||
post_logout_redirect_uris |
array of string |
否 | ['["https://admin.autional.cn/"]'] |
PostLogoutRedirectURIs 登出回跳白名单(OIDC RP-Initiated Logout 1.0 独立注册面,ADR-1) | |
privacy_policy |
string |
否 | https://app.example.com/privacy |
||
redirect_uris |
array of string |
否 | ['["https://app.example.com/callback"]'] |
||
scopes |
array of string |
否 | ['["openid"', '"profile"]'] |
||
secret_last_four |
string |
否 | bcde |
||
status |
string |
否 | active |
||
tenant_id |
string |
否 | tenant_abc123 |
||
terms_url |
string |
否 | https://app.example.com/terms |
||
updated_at |
string |
否 | 2026-04-15T10:30:00Z |
||
website |
string |
否 | https://app.example.com |
service-oauth/internal/handler/dto.OAuthClientItemDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-oauth/internal/handler/dto.OAuthClientItem |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |