GET /admin/oauth/clients

返回当前租户下分页的 OAuth 客户端列表,支持按名称和状态过滤

OAuth 客户端管理 `bearerAuth` application/json

请求参数

名称位置类型必填默认值示例约束描述
page query integer 否 1 页码
page_size query integer 否 20 每页数量
name query string 否 按名称搜索
status query string 否 按状态筛选(active/suspended)

响应

状态描述Schema
200客户端列表service-oauth/internal/handler/dto.OAuthClientListResponse
400请求参数错误service-core/base/dto.SimpleResponse
401未认证:请提供有效的 Bearer Tokenservice-core/base/dto.SimpleResponse
403权限不足:需要管理员权限service-core/base/dto.SimpleResponse
500服务内部错误service-core/base/dto.SimpleResponse

引用的 Schema

service-core/base/dto.PageInfo

字段类型必填示例约束描述
has_next boolean 否 HasNext indicates whether there is a next page
has_prev boolean 否 HasPrev indicates whether there is a previous page
page integer 否 Page is the current page number (1-based)
page_size integer 否 PageSize is the number of items per page
total integer 否 Total is the total number of items across all pages
total_pages integer 否 TotalPages is the total number of pages

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.OAuthClientListResponse

字段类型必填示例约束描述
code integer 否
items array of

参见 service-oauth/internal/handler/dto.OAuthClientItem

否 统一使用 items
message string 否
pagination object 否 分页信息(嵌套对象)
timestamp string 否
total integer 否 总条数(平铺,便于直接读取)