A AuthMS API Wiki API Reference iam.tianv.com →

GET /admin/oauth/clients

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

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

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
page query integer No 1 页码
page_size query integer No 20 每页数量
name query string No 按名称搜索
status query string No 按状态筛选(active/suspended)

Responses

StatusDescriptionSchema
200客户端列表dto.OAuthClientListResponse
400请求参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证:请提供有效的 Bearer Tokengitee_com_linmes_authms_base_dto.SimpleResponse
403权限不足:需要管理员权限gitee_com_linmes_authms_base_dto.SimpleResponse
500服务内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.OAuthClientItem

FieldTypeRequiredExampleConstraintsDescription
client_auth_methods string No ["client_secret_basic","private_key_jwt"]
client_id string No app-123
cors_origins array of

string

No ['["https://app.example.com"]']
created_at string No 2026-04-15T10:30:00Z
deleted_at string No
fapi_profile string No fapi1
grant_types array of

string

No ['["authorization_code"]']
id string No client_abc123
is_confidential boolean No True
jwks_uri string No https://client.example.com/.well-known/jwks.json
logo_url string No https://app.example.com/logo.png
name string No My App
privacy_policy string No https://app.example.com/privacy
redirect_uris array of

string

No ['["https://app.example.com/callback"]']
scopes array of

string

No ['["openid"', '"profile"]']
secret_last_four string No bcde
status string No active
tenant_id string No tenant_abc123
terms_url string No https://app.example.com/terms
updated_at string No 2026-04-15T10:30:00Z
website string No https://app.example.com

dto.OAuthClientListResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
items array of

See dto.OAuthClientItem

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

gitee_com_linmes_authms_base_dto.PageInfo

FieldTypeRequiredExampleConstraintsDescription
has_next boolean No HasNext indicates whether there is a next page
has_prev boolean No HasPrev indicates whether there is a previous page
page integer No Page is the current page number (1-based)
page_size integer No PageSize is the number of items per page
total integer No Total is the total number of items across all pages
total_pages integer No TotalPages is the total number of pages

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No