/admin/oauth/clients
返回当前租户下分页的 OAuth 客户端列表,支持按名称和状态过滤
请求参数
| 名称 | 位置 | 类型 | 必填 | 默认值 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|---|---|
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 Token | service-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 |
否 | 统一使用 items | ||
message |
string |
否 | |||
pagination |
object |
否 | 分页信息(嵌套对象) | ||
timestamp |
string |
否 | |||
total |
integer |
否 | 总条数(平铺,便于直接读取) |