GET `/admin/verifications`

管理员查询租户下所有实名认证记录，支持按认证状态、日期范围过滤和分页，返回脱敏后的认证信息列表

验证服务 `bearerAuth` application/json

请求参数

名称	位置	类型	必填	默认值	示例	约束	描述
`status`	`query`	`string`	否				认证状态过滤：verified/pending/rejected/expired
`date_from`	`query`	`string`	否				起始日期 (YYYY-MM-DD)
`date_to`	`query`	`string`	否				截止日期 (YYYY-MM-DD)
`page`	`query`	`integer`	否				页码，默认1
`page_size`	`query`	`integer`	否				每页数量，默认20

响应

状态	描述	Schema
200	认证列表，包含脱敏后的认证信息	`dto.ListResponse-service-verification/internal/handler/dto/VerificationListItem`
400	请求参数错误	`dto.SimpleResponse`
401	未认证或令牌无效	`dto.SimpleResponse`
403	权限不足	`dto.SimpleResponse`
404	资源不存在	`dto.SimpleResponse`
500	服务内部错误	`dto.SimpleResponse`

引用的 Schema

dto.ListResponse-service-verification/internal/handler/dto/VerificationListItem

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`items`	array of 参见 `service-verification/internal/handler/dto.VerificationListItem`	否			统一使用 items
`message`	`string`	否
`pagination`	`object`	否			分页信息（嵌套对象）
`timestamp`	`string`	否
`total`	`integer`	否			总条数（平铺，便于直接读取）

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

dto.SimpleResponse

字段	类型	必填	示例	约束	描述
`code`	`integer`	否
`message`	`string`	否
`timestamp`	`string`	否

service-verification/internal/handler/dto.VerificationListItem

字段	类型	必填	示例	约束	描述
`age_group`	`string`	否
`created_at`	`string`	否
`expires_at`	`string`	否
`id`	`string`	否
`liveness_score`	`string`	否
`method`	`string`	否
`provider`	`string`	否
`rejected_reason`	`string`	否
`retry_count`	`integer`	否
`status`	`string`	否
`updated_at`	`string`	否
`user_id`	`string`	否
`verified_at`	`string`	否

在 Scalar 中试用此 API → 下载 OpenAPI 规范（JSON）↓